iniparser库介绍应用

一、 iniparser库介绍

最近写实验代码，经常要ini解析配置文件，到底什么是ini配置文件？

• iniparser是一个C语言库，是针对INI文件的开源解析器
• ini文件是一些系统或者软件的配置文件
• iniparser库中的API函数可以对ini文件(配置文件)进行解析、配置、删除等操作

下载iniparser库：
Github:https://github.com/ndevilla/iniparser
下载解压之后切换到iniparser-master文件夹中，进入src文件

• 可以看到dictionary.h申明了一些直接解析ini文件的API函数
• 还有iniparser.h里提供了一些用户操作的API
• 其实iniparser.h里的API就是对dictionary.h里的API再次封装

INI文件的基本格式如下： （我们写一个名为config.ini的配置文件）

；地址池    //注释都用分号打头
[ipaddrpool]     //多个key归类为一组(section),组名要用中括号括起来
start              =192.168.1.1    //一个key元素或者叫property,有名字(name)对应的值(value)
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

注意：

• 不同的组别中的key名字可以相同
• ini配置文件不区分大小写，最后都会转化成小写

二、iniparser.h

介绍一下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

介绍一下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对象 

测试代码

初步了解之后，我们就来写一段代码来修改上文中config.ini文件中的参数配置
config.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

测试文件

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


#define PATH "./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;
}

这篇博客也借鉴了很多人的博文，因为自己写代码要用到ini配置文件解析，所以记录一下大概用法，作为学习笔记，方便自己查阅