ini配置文件的学习和iniparser库的学习

INI配置文件的格式

为什么要用INI文件？如果我们程序没有任何配置文件时，这样的程序对外是全封闭的，一旦程序需要修改一些参数必须要修改程序代码本身并重新编译，这样很不好，所以要用配置文件，让程序出厂后还能根据需要进行必要的配置，就不需要去更改程序了。
INI文件由节、键、值组成。
节 　　[section]
参数（键=值） name=value ，ini文件的最基本组成单元就是key或者叫property，每个key都有一个名称（name）和对应的值（value）
注解 　　注解使用分号表示（;）。在分号后面的文字，直到该行结尾都全部为注解。

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

iniparser基本API

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

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

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

2.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文件里的内容

 ;订阅端
  2 [sub]
  3 HOST = "localhost"
  4 PORT = 1883
  5 KEEP_ALIVE = 60

进行修改

 /*********************************************************************************
  2  *      Copyright:  (C) 2021 Li Guangming
  3  *                  All rights reserved.
  4  *
  5  *       Filename:  ini_text.c
  6  *    Description:  This file 
  7  *                 
  8  *        Version:  1.0.0(14/07/21)
  9  *         Author:  Li Guangming <2360217827@qq.com>
 10  *      ChangeLog:  1, Release initial version on "14/07/21 08:39:01"
 11  *                 
 12  ********************************************************************************/
 13 #include<stdio.h>
 14 #include<iniparser.h>
 15 #include<dictionary.h>
 16 
 17 #define PATH "/home/iot11/liguangming/rpiMonitor/mosquitto_text/mosq.ini"
 18 
 19 int main ()
 20 {
 21     FILE *fp = NULL;
 22     dictionary *ini = NULL;
 23 
 24     ini = iniparser_load(PATH); //解析dictionary对象并返回(分配内存)dictionary对象
 25 
 26     if(ini == NULL)
 27     {
 28         printf("iniparser failed\n");
 29         return -1;
 30     }
 31 
 32     iniparser_set(ini,"sub:host","127.0.0.1"); //设置dictionary对象的某个section:key的值 
 33     iniparser_set(ini,"sub:port","6666");
 34     iniparser_set(ini,"sub:keep_alive","80");
 
 35     /* 设置完相应的值后还要再写回配置文件里面保存下来*/
 
 36     fp = fopen(PATH,"w");//  打开这个文件，并允许对这个文件进行写的操作。
 37     if(fp == NULL)
 38     {
 39        printf("fopen error\n");
 40        exit(1);
 41     }
 42 
 43     iniparser_dumpsection_ini(ini,"sub",fp);//保存dictionary对象一个section到file中
 44     fclose(fp);
 45 
 46     iniparser_freedict(ini);//用完了要给释放掉，释放dictionary对象(内存)
 47 
 48 }

修改的结果

[sub]
  3 host                           = 127.0.0.1
  4 port                           = 6666
  5 keep_alive                     = 80