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