C语言配置文件解析库——iniparser

C语言配置文件解析库——iniparser

前言:在对项目的优化时,发现Linux下没有专门的供给C语言使用的配置文件函数,于是搜索到了iniparser库,可以像那些面向对象语言一样,使用ini文件进行参数配置。

介绍

iniparser是针对INI文件的解析器。ini文件则是一些系统或者软件的配置文件。

iniparser库有四种下载方式:

1.官方网站

2.我的github

3.我的网盘

4.source code tree

基本语法

Iniparser库的API可以对ini文件(配置文件)进行解析、设置、删除等操作。

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

name=value

1

而许多个Key可以被归类为一组,即section。组名定义要独立一行,并用中括号括起来:

[section]

name=value

1

2

在section声明下的keys都会和该section关联起来。一个section的作用域会在下一个section声明的地方结束,如果没有下一个section的声明,那么该section的结束地方就是该文件末尾。section是不可以嵌套的。

定位一个key是用section:key来表示的,所以不同section下的key的名称是可以相同的。

iniparser库处理名称的时候,会统一换成小写,所以section和property的名称命名是大小写无关的。

注释要以分号开头:

;comment

1

API

iniparser.h:

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

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对象

示例

首先解压你下载的库文件:

tar -zxvf iniparser-3.1.tar.gz

编译:

cd iniparser-3.1/

make

可以看到src目录下生成了六个文件,其中dictionary.h里面声明了一些直接解析ini file的API,iniparser.h里面声明了一些提供用户操作的API。iniparser.h里面的API是对dictionary.h里面API的再次封装,以提供用户友好性。

然后拷贝src下的头文件dictionary.h和iniparser.h以及压缩包目录下的静态库libiniparser.a和动态库libiniparser.so.0到目标文件系统的对应目录下。

编写ini文件:

#ini file for example

[tcp]

;for tcp communication

port = 8000;

ip = 127.0.0.1;

family = AF_INET;

[serial port]

;for serial port communication

speed = 9600;

测试代码:

#include <stdio.h>

#include <stdlib.h>

#include "iniparser.h"

int main(void)

{

    dictionary *ini;

    int n = 0;

    char *str;

    ini = iniparser_load("example.ini");//parser the file

    if(ini == NULL)

    {

        fprintf(stderr,"can not open %s","example.ini");

        exit(EXIT_FAILURE);

    }

    printf("dictionary obj:\n");

    iniparser_dump(ini,stderr);//save ini to stderr

    printf("\n%s:\n",iniparser_getsecname(ini,0));//get section name

    n = iniparser_getint(ini,"tcp:port",-1);

    printf("port : %d\n",n);

    str = iniparser_getstring(ini,"tcp:ip","null");

    printf("ip : %s\n",str);

    str = iniparser_getstring(ini,"tcp:family","null");

    printf("family : %s\n",str);

    printf("\n%s:\n",iniparser_getsecname(ini,1));

    n = iniparser_getint(ini,"serial port:speed",-1);

    printf("speed : %d\n",n);

    iniparser_freedict(ini);//free dirctionary obj

    return 0;

}

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

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对象

运行:

gcc example.c -o example -L. -liniparser

./example

结果:

dictionary obj:

[tcp]=UNDEF

[tcp:port]=[8000]

[tcp:ip]=[127.0.0.1]

[tcp:family]=[AF_INET]

[serial port]=UNDEF

[serial port:speed]=[9600]

tcp:

port : 8000

ip : 127.0.0.1

family : AF_INET

serial port:

speed : 9600

总结

这个库对配置文件的管理还是很方便的,常用的功能基本都包含了

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 221,548评论 6 515
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 94,497评论 3 399
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 167,990评论 0 360
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,618评论 1 296
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,618评论 6 397
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 52,246评论 1 308
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,819评论 3 421
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,725评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 46,268评论 1 320
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,356评论 3 340
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,488评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 36,181评论 5 350
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,862评论 3 333
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,331评论 0 24
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,445评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,897评论 3 376
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,500评论 2 359

推荐阅读更多精彩内容