iniparser 使用小结

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

  https://github.com/ndevilla/iniparser

  iniparser提供API接口对ini文件进行解析、配置、删除等操作。ini文件基本格式如下所示：

[pizza]
ham                            = yes
mushrooms                      = TRUE
capres                         = 0
cheese                         = Non


[wine]
grape                          = Cabernet Sauvignon
year                           = 2018
country                        = USA
alcohol                        = 12.5


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

  ham       =    yes

ham       就是名称name， yes 是对应的值；

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

如 [wine]

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

  需要注意的是，每个组下的key是唯一的不能重复的，但不同组下可以存在相同key。

 

  注释以分号开头：

  ；地址池

  iniparser基本API---------

// 加载ini文件，将数据存于dictionary结构中
   dictionary * iniparser_load(const char * ininame);

  //   获取对应key的value。key以组+key的形式体现，如“ipaddrpool:start”。value以字符串形式返回，若未找到对应的key则返回

//def 的内容。

   const char * iniparser_getstring(const dictionary * d, const char * key, const char * def);

//修改dictionary结构中对应键值的内容。entry是键值，如“ipaddrpool:start”。val是待设置的新值。设置成功返回0，否则-1。

   int iniparser_set(dictionary * ini, const char * entry, const char * val); 

//   将dictionary中对应组的数据写入一个已打开的文件中。s是组名，f是文件流。

   void iniparser_dumpsection_ini(const dictionary * d, const char * s, FILE * f);

//保存至文件

void iniparser_dump_ini(dictionary * d, FILE * f)；

//   释放dictionary结构

   void iniparser_freedict(dictionary * d);

--------------------- 

例程（已测试）：

#pragma onece
#include "iniparser.h"
#include "dictionary.h"

#define WRONG
void creat_inifile(char *name)
{
    FILE    *   ini ;

    ini = fopen(name, "w");
    fprintf(ini,
    "#\n"
    "# This is an example of ini file\n"
    "#\n"
    "\n"
    "[Pizza]\n"
    "\n"
    "Ham       = yes ;\n"
    "Mushrooms = TRUE ;\n"
    "Capres    = 0 ;\n"
    "Cheese    = Non ;\n"
    "\n"
    "\n"
    "[Wine]\n"
    "\n"
    "Grape     = Cabernet Sauvignon ;\n"
    "Year      = 1989 ;\n"
    "Country   = Spain ;\n"
    "Alcohol   = 12.5  ;\n"
    "\n");
    fclose(ini);

    return;
}

void read_inifile(char *name)
{
    char buf[256];
    int a=0;
    //Parse an ini file and return an allocated dictionary object
    dictionary * dict = iniparser_load(name);
#ifdef WRONG
    a = iniparser_getint(dict, "Wine:Year", 10);
#else
    a = iniparser_getint(dict, "Wine:Null", 10);
#endif
    printf("get Wine:Year = %d\n",a);
#ifdef WRONG

    strcpy(buf , iniparser_getstring(dict,"Wine:Country", "China"));
#else
    strcpy(buf , iniparser_getstring(dict,"Wine:Null", "China"));
#endif
    printf("get Wine:Country = %s\n",buf);

    iniparser_freedict(dict);

    return;
}

void change_inifile(const char *name)
{
    int re = 0;
    dictionary * dict = iniparser_load(name);
    
    if(iniparser_set(dict, "Wine:Year", "2018"))
        printf("set \"Wine:Year\" is wrong\n");
    if(iniparser_set(dict, "Wine:Country", "USA"))
        printf("set \"Wine:Country\" is wrong\n");
#if 1
    FILE * f = fopen(name,"w");
//don't use iniparser_dump() to save ,the two function is not different
    iniparser_dump_ini(dict, f);
        
    fclose(f);
#endif
    iniparser_freedict(dict);

    return;
}

int main(int argc, char * argv[])
{
     creat_inifile("example.ini");
    
    read_inifile("example.ini");

    change_inifile("example.ini");
    
    read_inifile("example.ini");

    return 0 ;
}

参考：https://blog.csdn.net/stone8761/article/details/81100747