iniparser 库的简单使用

1 iniparser介绍

iniparser是一个C语言库，是针对INI文件的开源解析器。ini文件则是一些系统或者软件的配置文件。
github地址如下：

https://github.com/ndevilla/iniparser

直接git clone

• 关键的头文件和c文件在src下

2 ini文件格式

• 我自己定义了一个配置文件,和测试代码

ini文件的最基本组成单元就是key或者叫property，每个key都有一个名称(name)和对应的值(value)

• router是代表section，就是一组，你可以定义很多组别。
• ssid和passward是key，=后面的是对应的值

；代表注释

注意，配置文件不区分大小写，最后都会转换成小写，另外不同组别中的key名字可以相同

3 iniparser.h

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

4 dictionary.h

unsigned dictionary_hash(const char * key); //计算关键词的hash值  
dictionary * dictionary_new(int size);  //创建dictionary对象  
void dictionary_del(dictionary * vd);   //删除dictionary对象  
char * dictionary_get(dictionary * d, const char * key, char * def);    //获取dictionary对象的key值  
int dictionary_set(dictionary * vd, const char * key, const char * val);    //设置dictionary对象的key值  
void dictionary_unset(dictionary * d, const char * key);    //删除dictionary对象的key值  
void dictionary_dump(dictionary * d, FILE * out);   //保存dictionary对象 

5 常用的几个函数

• 我们一般用到下面几个函数

dictionary * iniparser_load(const char * ininame);

加载ini文件，将数据存于dictionary结构中
------------------------------------------------------------------------------------------
const char * iniparser_getstring(const dictionary * d, const char * key, const char * def);

获取对应key的value。key以组+key的形式体现，如“ipaddrpool:start”。value以字符串形式返回，
若未找到对应的key则返回def 的内容。
----------------------------------------------------------------------------------------------------
int iniparser_set(dictionary * ini, const char * entry, const char * val);

修改dictionary结构中对应键值的内容。entry是键值，如“ipaddrpool:start”。val是待设置的新值。
设置成功返回0，否则-1。
---------------------------------------------------------------------------------------
void iniparser_dumpsection_ini(const dictionary * d, const char * s, FILE * f);

将dictionary中对应组的数据写入一个已打开的文件中。s是组名，f是文件流。
----------------------------------------------------------------------------------------------------
void iniparser_freedict(dictionary * d);

释放dictionary结构

6 测试代码

• 下面桦桦编写代码读取配置文件中的值

#include <stdio.h>
#include "iniparser.h"
#include "dictionary.h"


#define PATH "./config.ini"

int main (int argc, char **argv)
{
    dictionary *ini= NULL;
    ini = iniparser_load(PATH);

    if( ini ==NULL)
    {
        printf("inipar  failure\n");
        return -1;
    }

    const char *ssid = iniparser_getstring(ini, "router:ssid", "null");
	const char *passward  = iniparser_getstring(ini, "router:passward", "null");
    
    printf("%s\n", ssid);
    printf("%s\n",passward);

    printf("%s\n" ,  dictionary_get(ini, "router:passward", "null"));
    
    iniparser_freedict(ini);

    return 0;
}

gcc *.c