Linux c/c++编程--知识点（13）（iniparser库）用于解析ini配置文件，iniparser库的使用

文章原文：

返回知识列表：Linux c/c++编程-- 知识点汇总

---

• 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 <stdio.h>

#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对象(内存)