- iniparser库的位置:
Github: https://github.com/ndevilla/iniparser
我下载下来的文件: iniparser-master.zip
- 项目中经常遇到需要解析ini配置文件的需求。ini配置文件的格式,如下
[tvconfig]
name = niubi
version = 10.2.3.4
date = 2018.10.2
[user]
name = dashen
age = 18
ini文件的最基本组成单元就是key或者叫property,每个key都有一个名称(name)和对应的值(value),例如:
date = 2018.1.2
而许多个Key可以被归类为一组,即section。组名定义要独立一行,并用中括号括起来,例如
[tvconfig]
在section声明下的keys都会和该section关联起来。一个section的作用域会在下一个section声明的地方结束,如果没有下一个section的声明,那么该section的结束地方就是该文件末尾。section是不可以嵌套的。
定位一个key是用section:key来表示的,所以不同section下的key的名称是可以相同的。
iniparser库处理名称的时候,会统一换成小写,所以section和property的名称命名是大小写无关的。
注释: 要以分号开头或者是用#号,都可以作为注释开头。不能使用c,c++的注释方式,即// 和 /***/
######### this is ok
;;;;;;;;; this is ok
// this is error
/**this is error*/
如下是自己使用iniparser这个开源库,进行的测试。
#include
#include "iniparser.h"
#include "dictionary.h"
int main()
{
printf("hello world\n");
dictionary *dic;
/*-------------------------------------------------------------------------*/
/** 这一段是直接摘自iniparser.c中的函数说明,敬请参考。
@brief Parse an ini file and return an allocated dictionary object
@param ininame Name of the ini file to read.
@return Pointer to newly allocated dictionary
This is the parser for ini files. This function is called, providing
the name of the file to be read. It returns a dictionary object that
should not be accessed directly, but through accessor functions
instead.
The returned dictionary must be freed using iniparser_freedict().
*/
/*--------------------------------------------------------------------------*/
if(NULL == (dic = iniparser_load("./setting.ini"))){
printf("ERROR: open file failed!\n");
return -1;
}
//向stdout 流中输出dic解析出的配置信息
//这只是用于debug.
iniparser_dump_ini(dic, stdout);
int count = 0;
//正如前面所说,要取value.使用的key值应该是section:key
//就如下面的running:auto_run_count
if(1 != (count = iniparser_getlongint(dic,"running:auto_run_count",1))){
printf("auto_run_count is %d \n",count);
}else{
printf("can't find auto_run_count");
}
//释放dic相关联的内存。该函数无返回值。
iniparser_freedict(dic);
return 0;
}
如下是测试用的 setting.ini 配置文件中的信息。
[running]
Name=Yu_Ricardo
auto_run_count = 10
auto_run_arg1 = main
auto_run_arg2 = zzz
auto_run_arg3 = ui
通过,gcc 编译并运行后的结果如下:
Test_useInilib# gcc -c useIniparserTest.cpp
Test_useInilib# gcc -o use useIniparserTest.o dictionary.o iniparser.o
Test_useInilib# ./use
hello world
[running]
name = Yu_Ricardo
auto_run_count = 10
auto_run_arg1 = main
auto_run_arg2 = zzz
auto_run_arg3 = ui
auto_run_count is 10
inparser库中的其他函数,
int iniparser_getnsec(dictionary * d); //获取dictionary对象的section个数
char * iniparser_getsecname(dictionary * d, int n); //获取dictionary对象的第n个section的名字
void iniparser_dump_ini(dictionary * d, FILE * f); //保存dictionary对象到file
void iniparser_dumpsection_ini(dictionary * d, char * s, FILE * f); //保存dictionary对象一个section到file
void iniparser_dump(dictionary * d, FILE * f); //保存dictionary对象到file
int iniparser_getsecnkeys(dictionary * d, char * s); //获取dictionary对象某个section下的key个数
char ** iniparser_getseckeys(dictionary * d, char * s); //获取dictionary对象某个section下所有的key
char * iniparser_getstring(dictionary * d, const char * key, char * def); //返回dictionary对象的section:key对应的字串值
int iniparser_getint(dictionary * d, const char * key, int notfound); //返回idictionary对象的section:key对应的整形值
double iniparser_getdouble(dictionary * d, const char * key, double notfound); //返回dictionary对象的section:key对应的双浮点值
int iniparser_getboolean(dictionary * d, const char * key, int notfound); //返回dictionary对象的section:key对应的布尔值
int iniparser_set(dictionary * ini, const char * entry, const char * val); //设置dictionary对象的某个section:key的值
void iniparser_unset(dictionary * ini, const char * entry); //删除dictionary对象中某个section:key
int iniparser_find_entry(dictionary * ini, const char * entry) ; //判断dictionary对象中是否存在某个section:key
dictionary * iniparser_load(const char * ininame); //解析dictionary对象并返回(分配内存)dictionary对象
void iniparser_freedict(dictionary * d); //释放dictionary对象(内存)