iniparser简介

---

前言

INI文件格式是某些平台或软件上的配置文件的非正式标准，以节(section)和键(key)构成，常用于微软Windows操作系统中。这种配置文件的文件扩展名多为INI，故名。
INI是英文“初始化”（initialization）的缩写。正如该术语所表示的，INI文件被用来对操作系统或特定程序初始化或进行参数设置。
iniparser是一个C语言库，是针对INI文件的开源解析器。

一、ini文件格式

基本组成单元：key 或者 称之为 property， 每个key都有一个名称(name)和对应的值(value)，例如：host = ghcey1O2Yxm.iot-as-mqtt.cn-shanghai.aliyuncs.com
host就是name，ghcey1O2Yxm.iot-as-mqtt.cn-shanghai.aliyuncs.com是value。

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

[address]
host    =   ghcey1O2Yxm.iot-as-mqtt.cn-shanghai.aliyuncs.com
port    =   1883

其中address就是组名，组成员有host和port。

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

注释以分号开头。

二、iniparser

1.下载

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

2.使用方法

git clone https://github.com/ndevilla/iniparser.git

cd iniparser

cd src

说明：dictionary.h里面声明了一些直接解析ini file的API，iniparser.h里面声明了一些提供用户操作的API。iniparser.h里面的API是对dictionary.h里面API的再次封装，以提供用户友好性。
将这四个文件放入自己的项目中即可。

3.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   
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中的API

;地址池
[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 

2.test.c

/*********************************************************************************
 *      Copyright:  (C) 2021 lastbreath<2631336290@qq.com>
 *                  All rights reserved.
 *
 *       Filename:  iniparser_test.c
 *    Description:  This file 
 *                 
 *        Version:  1.0.0(10/17/2021)
 *         Author:  lastbreath <2631336290@qq.com>
 *      ChangeLog:  1, Release initial version on "10/17/2021 11:41:52 AM"
 *                 
 ********************************************************************************/

#include <stdio.h>

#include "iniparser.h"

#include "dictionary.h"

#define PATH "./config.ini"



int main (int argc, char **argv)
{
    FILE *fp = NULL;
    dictionary *inip = NULL;
    inip = iniparser_load(PATH);
    if(!inip)
    {
        printf("iniparser_load failure\n");
        return -1;
    }
    int n = iniparser_getnsec(inip);
    if(n)
    {
        for(int i = 0; i < n; i++)
        {
            printf("%s\n",iniparser_getsecname(inip,i));
            int i1 = iniparser_getsecnkeys(inip,iniparser_getsecname(inip,i));
             char *keys[i1];
            char *str = iniparser_getsecname(inip,i);
             iniparser_getseckeys(inip,str,keys);
            char **ptr = keys;
            for(int j = 0; j < i1; j++)
            
            {
                printf("%s\n",*ptr);
                ptr++;
                
            }
        }
    }
    else
    {
        printf("This file has no section!\n");
        return -1;
    }




    iniparser_set(inip,"ipaddrpool:start","192");
    iniparser_set(inip,"ipaddrpool:end","198");
    iniparser_unset(inip,"opt:dns1");

    FILE *fp1 = fopen(PATH,"w");
    iniparser_dump_ini(inip,fp1);
   iniparser_freedict(inip);

    fclose(fp1);

    return 0;
} 

3.makefile

all:
	gcc *.c -o test

run:
	./test

clean:
	rm ./test

4.运行结果截图