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       

而許多個Key可以被歸類為一組，即section。組名定義要獨立一行，并用中括号括起來：

[section]
name=value      

在section聲明下的keys都會和該section關聯起來。一個section的作用域會在下一個section聲明的地方結束，如果沒有下一個section的聲明，那麼該section的結束地方就是該檔案末尾。section是不可以嵌套的。

定位一個key是用section:key來表示的，是以不同section下的key的名稱是可以相同的。

iniparser庫處理名稱的時候，會統一換成小寫，是以section和property的名稱命名是大小寫無關的。

注釋要以分号開頭：

;comment      

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      

• 1

編譯：

cd iniparser-3.1/
make      

• 2

可以看到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;      

測試檔案：

/*************************************************************************
    > File Name: example.c
    > Author: AnSwEr
    > Mail: [email protected]
    > Created Time: 2015年10月22日 星期四 20時37分10秒
 ************************************************************************/

#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;
}      

運作：

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
      

總結

這個庫對配置檔案的管理還是很友善的，希望對您有幫助。

回報與建議

• 微網誌：​​@AnSwEr不是答案​​
• github：​​AnSwErYWJ​​
• 部落格：​​AnSwEr不是答案的專欄​​