C語言開源庫iniparser解析ini文件的方法
更新時(shí)間：2024年04月26日 10:49:39 作者：大草原的小灰灰
INI（Initialization?File）文件是一種簡單直觀的數(shù)據(jù)存儲(chǔ)格式,常用于配置應(yīng)用程序的初始化設(shè)置,使用?iniparser?庫的應(yīng)用程序可以很方便地讀取和解析INI文件中的配置信息,大大簡化了對(duì)配置文件的處理工作,降低了程序的開發(fā)復(fù)雜度,感興趣的的朋友跟隨小編一起看看吧
1 ini文件介紹
- INI（Initialization File）文件是一種簡單直觀的數(shù)據(jù)存儲(chǔ)格式，常用于配置應(yīng)用程序的初始化設(shè)置。這種文件通常包含若干個(gè)節(jié)（section）和鍵值對(duì)（key-value pairs）。INI文件的每一部分都是自描述性的，易于閱讀和編輯，使得非程序員也能輕易理解并修改配置參數(shù)。
- INI文件因其簡單易用性而在許多編程語言中廣泛應(yīng)用，尤其是在Windows操作系統(tǒng)中，很多應(yīng)用程序都采用INI文件作為配置文件。當(dāng)然，隨著XML、JSON等更豐富、更結(jié)構(gòu)化的數(shù)據(jù)交換格式的普及，INI文件在現(xiàn)代應(yīng)用程序中的使用相對(duì)減少，但在一些輕量級(jí)應(yīng)用或?qū)?dòng)速度有較高要求的情況下，仍然是一種常見且實(shí)用的配置文件格式。
2 ini文件結(jié)構(gòu)
- 節(jié)（Section）：INI文件中的各個(gè)部分通過方括號(hào) [] 包裹的名稱來定義，例如 [Section1]。每個(gè)節(jié)可以包含多個(gè)鍵值對(duì)。
- 鍵值對(duì)（Key-Value Pairs）：鍵和值之間用等號(hào) = 分隔，如 key1=value1。鍵通常是描述性質(zhì)的字符串，而值則可以是字符串、數(shù)字或其他類型的數(shù)據(jù)。
- 注釋：注釋行以分號(hào) ; 開始，直到行尾都被視為注釋內(nèi)容，不會(huì)被程序解析。
- 多行值：某些INI解析器允許值跨越多行，通常通過在行尾添加反斜杠 \ 來延續(xù)到下一行
iniparser
iniparser 是一個(gè)開源的 C 語言庫，用于解析和操作 INI 格式的配置文件
使用 iniparser 庫的應(yīng)用程序可以很方便地讀取和解析INI文件中的配置信息，大大簡化了對(duì)配置文件的處理工作，降低了程序的開發(fā)復(fù)雜度。由于其開源屬性，開發(fā)者可以根據(jù)自己的需求自由使用、研究和改進(jìn)該庫。
3 相關(guān)API
3.1 加載ini文件
/* * @brief 從ini格式的配置文件中加載數(shù)據(jù) * @param [IN] ininame 要打開的ini格式文件 * @return != NULL 返回一個(gè)指向dictionary結(jié)構(gòu)的指針 * == NULL 加載ini文件失敗 */ dictionary * iniparser_load(const char *ininame);
3.2 獲取鍵值
/* * @brief 獲取指定鍵（key）對(duì)應(yīng)的字符串類型的值 * @param [IN] d dictionary結(jié)構(gòu)的指針 * @param [IN] key 要查找的鍵，通常格式為 "section:key"，表示要獲取哪個(gè)節(jié)（section）下的哪一項(xiàng)（key）的值。 * @param [IN] def 當(dāng)鍵不存在或者其值不是字符串時(shí)的默認(rèn)返回值。如果沒有找到對(duì)應(yīng)鍵，函數(shù)將返回此默認(rèn)值。 * @return 如果找到了相應(yīng)的鍵，返回鍵值對(duì)應(yīng)字符串 * 如果沒有找到匹配的鍵，返回def指定的字符串值 */ const char * iniparser_getstring(const dictionary *d, const char *key, const char *def); /* * @brief 獲取指定鍵（key）對(duì)應(yīng)的整數(shù)值 * @param [IN] d dictionary結(jié)構(gòu)的指針 * @param [IN] key 要查找的鍵，通常格式為 "section:key"，表示要獲取哪個(gè)節(jié)（section）下的哪一項(xiàng)（key）的值。 * @param [IN] notfound 當(dāng)鍵不存在或者其值不能被轉(zhuǎn)換為整數(shù)時(shí)，函數(shù)將返回這個(gè)默認(rèn)值。 * @return 如果找到了相應(yīng)的鍵，并且其值可以被成功轉(zhuǎn)換為整數(shù)，則返回該整數(shù)值。 * 如果沒有找到匹配的鍵，或者該鍵對(duì)應(yīng)的值無法轉(zhuǎn)換為整數(shù)，則返回 notfound 參數(shù)提供的默認(rèn)值。 */ int iniparser_getint(const dictionary * d, const char * key, int notfound); /* * @brief 獲取指定鍵（key）對(duì)應(yīng)的浮點(diǎn)型值 * @param [IN] d dictionary結(jié)構(gòu)的指針 * @param [IN] key 要查找的鍵，通常格式為 "section:key"，表示要獲取哪個(gè)節(jié)（section）下的哪一項(xiàng)（key）的值。 * @param [IN] notfound 當(dāng)鍵不存在或者其值無法轉(zhuǎn)換為雙精度浮點(diǎn)數(shù)時(shí)，函數(shù)返回的默認(rèn)值。 * @return 如果找到了相應(yīng)的鍵，并且其值能成功轉(zhuǎn)換為一個(gè)雙精度浮點(diǎn)數(shù)，則返回該浮點(diǎn)數(shù)。 * 如果沒有找到匹配的鍵，或者鍵的值不能被解釋為一個(gè)有效的雙精度浮點(diǎn)數(shù)，則返回 notfound 參數(shù)所提供的默認(rèn)值。 */ double iniparser_getdouble(const dictionary *d, const char *key, double notfound);
3.3 設(shè)置鍵值
/* * @brief 設(shè)置或修改 ini 配置文件中某個(gè)鍵值對(duì) * @param [IN] d dictionary結(jié)構(gòu)的指針 * @param [IN] entry 字符串形式的鍵值對(duì)標(biāo)識(shí)符，格式通常是 "section:key"，表明您要在哪個(gè)節(jié)(section)下的哪個(gè)鍵(key)上設(shè)置或修改值(val)。 * key值存在則修改對(duì)應(yīng)val，key值不存在則會(huì)新增 * @param [IN] val: 要設(shè)置的新值，作為字符串傳遞。 * @return 返回0表示設(shè)置成功 */ int iniparser_set(dictionary *ini, const char *entry, const char *val);
3.4 移除鍵值
/* * @brief 移除 ini 配置文件中某個(gè)鍵值對(duì) * @param [IN] d dictionary結(jié)構(gòu)的指針 * @param [IN] entry 字符串形式的鍵名，包括可選的部分名稱（section）和鍵（key） * 如果不指定key，則會(huì)移除整個(gè)section */ void iniparser_unset(ini, const char *entry);
3.5 判斷鍵是否存在
/* * @brief 判斷 ini 配置文件是否存在某個(gè)鍵值 * @param [IN] d dictionary結(jié)構(gòu)的指針 * @param [IN] entry 字符串形式的鍵值對(duì)標(biāo)識(shí)符，格式通常是 "section:key" * @return 返回1表示存在，返回0表示不存在 */ int iniparser_find_entry(const dictionary *ini, const char *entry);
3.6 獲取section個(gè)數(shù)
/* * @brief 獲取ini配置文件中section的數(shù)量 * @param [IN] d dictionary結(jié)構(gòu)的指針 * @return 成功返回section個(gè)數(shù)，失敗返回 -1 */ int iniparser_getnsec(const dictionary * d); /* * @brief 獲取某個(gè)section值 * @param [IN] d dictionary結(jié)構(gòu)的指針 * @param [IN] n 指定獲取第幾個(gè)section值 * @return 成功返回獲取到的section值，失敗返回NULL */ const char *iniparser_getsecname(const dictionary * d, int n);
3.7 獲取section下key個(gè)數(shù)
/* * @brief 獲取ini配置文件中某個(gè)section的key個(gè)數(shù) * @param [IN] d dictionary結(jié)構(gòu)的指針 * @param [IN] s section * @return 返回指定section下的key個(gè)數(shù) */ int iniparser_getsecnkeys(dictionary * d, char * s); /* * @brief 獲取ini配置文件中某個(gè)section的所有key * @param [IN] d dictionary結(jié)構(gòu)的指針 * @param [IN] s section * @param [OUT] keys 通過這個(gè)參數(shù)輸出key，也可以通過返回值獲取 * @return 成功返回指定section下的key，失敗返回NULL */ const char **iniparser_getseckeys(const dictionary *d, const char *s, const char **keys)
3.8 保存dictionary對(duì)象到文件中
/* * @brief 保存dictionary對(duì)象到文件中 * @param [IN] d dictionary結(jié)構(gòu)的指針 * @param [IN] f 已打開的文件描述符 */ void iniparser_dump_ini(const dictionary *d, FILE *f);
3.9 釋放dictionary對(duì)象
/* * @brief 釋放dictionary對(duì)象 * @param [IN] d dictionary結(jié)構(gòu)的指針 */ void iniparser_freedict(dictionary * d);
4 演示
4.1 獲取鍵值
ini文件內(nèi)容
[head] accecpt = */* length = 100 host = 192.168.1.2 port = 8087 rate = 9.98 [body] accept = XML data = json length = 200
測試代碼
#include <stdio.h>
#include <iniparser.h>
int main(){
// 加載配置
dictionary* ini = iniparser_load("config.ini");
if(ini == NULL){
return -1;
}
// 獲取鍵值
const char* cHeadHost = iniparser_getstring(ini, "head:host", "127.0.0.1");
printf("cHeadHost %s\n", cHeadHost);
const char* cBodyData = iniparser_getstring(ini, "body:data", "welcome");
printf("cBodyData %s\n", cBodyData);
int iHeadPort = iniparser_getint(ini, "head:port", 80);
printf("iHeadPort %d\n", iHeadPort);
double iHeadReate = iniparser_getdouble(ini, "head:rate", 9.99);
printf("iHeadReate %.2lf\n", iHeadReate);
// 釋放dictionary對(duì)象
iniparser_freedict(ini);
return 0;
}打印結(jié)果
4.2 設(shè)置鍵值
ini文件內(nèi)容
[head] accecpt = */* length = 100 host = 192.168.1.2 port = 8087 rate = 9.98 [body] accept = XML data = json length = 200
測試代碼
#include <stdio.h>
#include <iniparser.h>
int main(){
// 加載配置
dictionary* ini = iniparser_load("config.ini");
if(ini == NULL){
return -1;
}
// 有對(duì)應(yīng)鍵值則修改
int ret = iniparser_set(ini, "body:data", "iniparser");
if (ret != 0){
printf("iniparser_set body:data failed.\n");
}
// 沒有對(duì)應(yīng)鍵值則添加
ret = iniparser_set(ini, "body:msg", "success");
if (ret != 0){
printf("iniparser_set body:data failed.\n");
}
// 設(shè)置值成功后要進(jìn)行保存
FILE* fp = fopen("config.ini", "w");
if( fp == NULL ) {
printf("open ini file failed.\n");
return -1;
}
// 保存dictionary對(duì)象到file
iniparser_dump_ini(ini, fp);
fclose(fp);
// 釋放dictionary對(duì)象
iniparser_freedict(ini);
return 0;
}設(shè)置后新的ini文件內(nèi)容
[head] accecpt = */* length = 100 host = 192.168.1.2 port = 8087 rate = 9.98 [body] accept = XML data = iniparser length = 200 msg = success
4.3 遍歷section和鍵值
ini文件內(nèi)容
[head] accecpt = */* length = 100 host = 192.168.1.2 port = 8087 rate = 9.98 [body] accept = XML data = iniparser length = 200 msg = success
測試代碼
#include <stdio.h>
#include <iniparser.h>
int main(){
// 加載配置
dictionary* ini = iniparser_load("config.ini");
if(ini == NULL){
return -1;
}
// 遍歷section
int sectionNum = iniparser_getnsec(ini);
if(sectionNum != -1){
for(int i = 0; i < sectionNum; i++){
const char* cSection = iniparser_getsecname(ini, i);
if(cSection != 0){
printf("cSection : %s\n", cSection);
}
}
}
// 遍歷某個(gè)section下的key
int keyNum = iniparser_getsecnkeys(ini, "body");
//獲取dictionary對(duì)象某個(gè)section下所有的key
char keys[10][1024] = { 0 };
const char **p = (const char **)keys;
const char **retKeys = iniparser_getseckeys(ini, "body", p);
for (int i = 0; i < keyNum; i++){
printf("%s ", p[i]);
}
printf("\n");
// 釋放dictionary對(duì)象
iniparser_freedict(ini);
return 0;
}打印結(jié)果
到此這篇關(guān)于C語言開源庫iniparser解析ini文件的文章就介紹到這了,更多相關(guān)C語言iniparser解析ini文件內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
Java?C++題解leetcode1598文件夾操作日志搜集器
這篇文章主要為大家介紹了Java?C++題解leetcode1598文件夾操作日志搜集器示例詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2022-09-09
雙鏈表：在單鏈表的每個(gè)結(jié)點(diǎn)中，再設(shè)置一個(gè)指向其前驅(qū)結(jié)點(diǎn)的指針域，下面這篇文章主要給大家介紹了關(guān)于利用C++實(shí)現(xiàn)雙鏈表基本接口的相關(guān)資料，需要的朋友可以參考借鑒，下面來一起看看吧。2017-08-08
本文主要介紹了Qt編寫地圖遷徙圖的實(shí)現(xiàn)示例，文中通過示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2021-12-12
本篇文章是對(duì)C++ 類型轉(zhuǎn)換的詳細(xì)介紹，需要的朋友參考下，小編覺得這篇文章寫的不錯(cuò)，希望能夠給你帶來幫助2021-11-11
利用C++如何實(shí)現(xiàn)一個(gè)阻塞隊(duì)列詳解
這篇文章主要給大家介紹了關(guān)于利用C++如何實(shí)現(xiàn)一個(gè)阻塞隊(duì)列的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-10-10
C語言線性表的順序表示與實(shí)現(xiàn)實(shí)例詳解
這篇文章主要介紹了C語言線性表的順序表示與實(shí)現(xiàn)實(shí)例詳解，對(duì)于學(xué)習(xí)數(shù)據(jù)結(jié)構(gòu)與算法的朋友很有參考借鑒價(jià)值,需要的朋友可以參考下2014-07-07
在進(jìn)行文本檢測時(shí)，我們常常會(huì)用矩形邊框?qū)z測到的內(nèi)容框除。這篇文章主要為大家介紹的是OpenCV中能實(shí)現(xiàn)這一效果的函數(shù)：boundingRect，感興趣的同學(xué)可以學(xué)習(xí)一下2021-12-12
這篇文章主要介紹了C語言實(shí)現(xiàn)圖的搜索算法,結(jié)合具體實(shí)例形式分析了C語言實(shí)現(xiàn)圖的定義及搜索相關(guān)操作技巧,需要的朋友可以參考下2017-06-06
這篇文章主要介紹了C++中析構(gòu)函數(shù)為何是虛函數(shù)問題，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2022-11-11
C語言數(shù)學(xué)問題與簡單DP01背包問題詳解
這篇文章主要介紹了C語言數(shù)學(xué)問題買不到的數(shù)目、螞蟻感冒、飲料換購與簡單DP01背包問題的解決，屬于藍(lán)橋杯省賽中的題目，感興趣的同學(xué)來看看吧2022-04-04