iniparser库的使用

一、iniparser的概念

iniparser是针对INI文件的解析器。ini文件则是一些系统或者软件的配置文件。iniparser库的API可以对ini文件（配置文件）进行解析、设置、删除等操作。

下载iniparser：
Github:https://github.com/ndevilla/iniparser

主要代码都在src目录下：

其中dictionary.h里面声明了一些直接解析ini file的API，iniparser.h里面声明了一些提供用户操作的API。iniparser.h里面的API是对dictionary.h 里面API的再次封装。

ini文件基本格式如下所示：

；地址池
[ipaddrpool]
start              =192.168.1.1
end	               =192.168.1.100

[filepath]
leasefile          =/var/dhcplease/dhcpd.leases

;网络接口
[network]
interface          =en1


[opt]
dns1                =8.8.8.8
dns2                =112.112.112.112
t1                  =38
t2                  =23

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

start = 192.168.1.1

“start” 就是名称name， “192.168.1.1”是对应的值；

我们还可以将多个key归类为一组，即section， 组名定义要独立一行，并用中括号括起来：

[ipaddrpool]
start = 192.168.1.1
end = 192.168.1.100

其中 [ipaddrpool] 就是组名， 组成员有”start“、”end“；

在section声明下的keys都会和该section关联起来。一个section的作用域会在下一个section声明的地方结束，如果没有sectionde 的声明，那么该section的结束地方就是该文件末尾。section是不可以嵌套的。
定位一个key是用section：key来表示的，所以不同section下的key名称是可以相同的。
iniparser库处理名称的时候，会统一换成小写，所以section和property的名称命名是大小写无关的。
需要注意的是，每个组下的key的唯一的不能重复的，但不同组下可以存在相同key。

注释要以分号开头：

；地址池

二、iniparser.h中的一些API

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

三、dictionary.h中的一些API

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对象 

四、在linux上用代码实现对ini文件的修改

原ini文件：

原文件里的代码：

；地址池
[ipaddrpool]
start                          = 192.168.1.1
end                            = 192.168.1.100
 
[filepath]
leasefile                      = /var/dhcplease/dhcpd.leases
 
;网络接口
[network]
interface                      = en1
 
[opt]
dns1                           = 8.8.8.8
dns2                           = 8.8.8.8
subnet                         = 255.255.255.0
router                         = 192.168.3.1
domain                         = local
lease                          = 864
t1                             = 432
t2                             = 756

我们用iniparser对这个ini文件进行修改：

/*********************************************************************************
 *      Copyright:  (C) 2020 makun<[email protected]>
 *                  All rights reserved.
 *
 *       Filename:  iniparser_test.c
 *    Description:  This file 
 *                 
 *        Version:  1.0.0(2020年07月08日)
 *         Author:  makun <[email protected]>
 *      ChangeLog:  1, Release initial version on "2020年07月08日 21时33分44秒"
 *                 
 ********************************************************************************/

#include 
#include "iniparser.h"
#include "dictionary.h"


#define PATH "/home/makun/iniparser1/config.ini"

int main (int argc, char **argv)
{
    FILE  *fp = NULL  ;
    dictionary *ini= NULL;

    ini = iniparser_load(PATH);

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

    //设置ipaddrpool
    iniparser_set(ini, "ipaddrpool:start", "192.168.0.0");
    iniparser_set(ini, "ipaddrpool:end", "192.168.1.1");

    printf("%s\n", iniparser_getstring(ini, "ipaddrpool:start", "null"));
    printf("%s\n", iniparser_getstring(ini, "ipaddrpool:end", "null"));
    printf("%s\n", iniparser_getstring(ini, "filepath:leasefile", "null"));
    printf("%s\n", iniparser_getstring(ini, "network:interface", "null"));
    printf("%s\n", iniparser_getstring(ini, "opt:dns1", "null"));
    printf("%s\n", iniparser_getstring(ini, "opt:dns2", "null"));
    printf("%s\n", iniparser_getstring(ini, "opt:subnet", "null"));
    printf("%s\n", iniparser_getstring(ini, "opt:router", "null"));
    printf("%s\n", iniparser_getstring(ini, "opt:domain", "null"));
    printf("%s\n", iniparser_getstring(ini, "opt:lease", "null"));
    printf("%s\n", iniparser_getstring(ini, "opt:t1", "null"));
    printf("%s\n", iniparser_getstring(ini, "opt:t2", "null"));


    fp = fopen(PATH, "w");
    if( fp == NULL ) {
        printf("stone:fopen error!\n");
        exit(-1);
    }

    iniparser_dumpsection_ini(ini, "ipaddrpool", fp);
    iniparser_dumpsection_ini(ini, "filepath", fp);
    iniparser_dumpsection_ini(ini, "network", fp);
    iniparser_dumpsection_ini(ini, "opt", fp);
    fclose(fp);

    iniparser_freedict(ini);



    return 0;
}

运行结果：


当代码运行结果后，我们把地址池里的ip修改了，当我们再次进入到ini文件里面，发现之前的ini数据发生了改变，不再是之前的那个，如下图

iniparser我相信通过我以上的知识及代码，大家应该学会了对iniparser库的使用了吧！如果有不懂的，请评论区留言，看到我会回复你，如果有错误的地方，还请你们指正！谢谢！

参考链接;https://blog.csdn.net/stone8761/article/details/81100747
https://blog.csdn.net/LANB0/article/details/50718507?utm_medium=distribute.pc_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-4.nonecase&depth_1-utm_source=distribute.pc_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-4.nonecase