zl程序教程

您现在的位置是:首页 >  其他

当前栏目

inifile 一个轻量级的INI文件解析库

文件 一个 解析 轻量级 ini
2023-09-14 09:01:04 时间
ini文件是一种常见的配置文件。它以简单的文字与简单的结构组成.INI文件会以不同的扩展名,如 .ini. , .cfg , .conf 等。 INI文件的格式 INI文件由3个重要的部分组成:参数(parameters),段(sections)和注释(comments).其格式如下: 段(sectio
ini文件是一种常见的配置文件。它以简单的文字与简单的结构组成.INI文件会以不同的扩展名,如".ini.",".cfg",".conf"等。

INI文件的格式 INI文件由3个重要的部分组成:参数(parameters),段(sections)和注释(comments).其格式如下:

段(sections)
[section] 参数(parameters)
name=value 注释(comments)
;comments
每个段包括段名,注释,和一定的参数对,段名不可重复。段内的参数对是有序的,可重复的。
注释一般以分号“;”开头,在分号后面的文字,直到该行结尾都全部为注解。但是也有很多的配置文件的注释是以“#”开头的。

一般来说,段与段直接的名字是不能重复的。而段内的参数对是有序的,可重复的。虽然这种重复参数的情况比较少,但是有些地方还是会用到的。如OceanBase数据库的 Schema配置文件如下。

[sys_table]

table_id=1

max_column_id=11

table_type=1

#rowkey is table name

rowkey_is_fixed_length=0 

column_info=table_name,varchar,128

column_info=table_id,int 

column_info=table_type,int

column_info=rowkey_len,int

column_info=max_column_id,int


INI文件不一定有段名,通常此时会为其增加一个默认的段名.

示例中存在段名,段名为sys_table,在配置文件中不能再存在其他sys_table段,而该段中的存在多个column_info参数,每个参数表示sys_table中的一个字段的信息。参数rowkey_is_fixed_length还带有注释。

注释是提高配置文件可读性的重要方法。在解析的过程中一般会被忽略。但是如果你准备给你的解析库添加一个保存到文件的功能的话,就应该考虑到用户可能会为每个参数或者段添加注释的可能性。

IniFile的接口设计 接口设计必须要保证足够的稳定性和易用性。INI配置文件通常是启动时读,一旦启动程序,中途几乎不会修改配置文件。所以一个简单的解析库,首要目标是解决INI文件的解析,然后是在内存中修改内容,以及将内存修改后的内容保存到INI文件中去。
完整的解析至少要包括以下功能:


获取section段第一个键为key的值,并将值赋到value中
int getValue(const string section,const string key,string value);


获取section段第一个键为key的值,并将值赋到value中,将注释赋到comment中
int getValue(const string section,const string key,string value,string comment);


获取section段所有键为key的值,并将值赋到values的vector中
int getValues(const string section,const string key,vector string values);


获取section段所有键为key的值,并将值赋到values的vector中,将注释赋到comments的vector中
int getValues(const string section,const string key,vector string value,vector string comments);


获取section段的注释
int getSectionComment(const string section,string comment);


如果要在程序中修改INI文件设置的值,并将修改后的内容保存到原来的INI文件或者其他文件,则需要包括以下功能:

将内容保存到当前文件
int save();
同时设置值和注释
int setValue(const string section,const string key,const string value,const string comment=""); 删除段
void deleteSection(const string section); 删除特定段的特定参数
void deleteKey(const string section,const string key); 设置section段的注释
int setSectionComment(const string section,const string comment);
IniFile库既包含了INI文件的解析,也能够修改并保存INI文件。
解析过程中如果INI文件中没有指定段名,则会指定一个空字符串作为段名,段采用map保存,而段中的参数则采用vector保存,因此支持参数名重复。

IniFile除了适合用在一般后台程序读取配置文件,也能够帮助GUI界面程序提供参数配置,修改,保存等。

IniFile的使用 使用很简单 生成一个ini文件test.ini
cat test.ini

#this is commit

;this is commit

[COMMON]

DB = mysql

PASSWD=root


首先指定头文件和命名空间 然后使用open函数打开ini文件 getValue可以获取指定段的指定项的值

#include "inifile.h"

using namespace inifile;

filepath = "test.ini";

IniFile ini;

ini.open(filepath);

//获取指定段的指定项的值

string db_name = ini.getValue("COMMON","DB");

//设置新值和注释

ini.setValue("TEST","NAME","root","用户名称");

//保存到文件

ini.save();



IniFile库的地址为:

https://github.com/Winnerhust/inifile2
PHP导出MYSQL数据库并压缩 PHP可以一键导出MYSQL备份文件,并压缩存放,尽管phpMyAdmin有这功能,不过若你自己开发网站或者是为别人写CMS,你不应该要求别人用你程序的时候再去另外用phpMyAdmin备份MYSQL