C语言 ini 文件读写【Iniparser库】
2026-08-17 02:44:54 职业百科一、概述
iniparser是针对INI文件的解析器。ini文件则是一些系统或者软件的配置文件。iniparser库的API可以对ini文件（配置文件）进行解析、设置、删除等操作。
常见的 ini 读写开源库有：minIni、inifile、iniparser
二、使用
下载
Github：https://github.com/ndevilla/iniparser
方式一
编译
下载后进入文件根目录，使用 make 命令编译，编译完成后会生成 libiniparser.a 和 libiniparser.so.1 文件
测试
iniparser 提供了测试程序，进入 example 目录，使用 make命令编译，完成后会生成 iniexample 执行文件
测试结果
注意事项
使用链接文件时，可以参考 example 目录下的 Makefile 文件
方式二
此方法使用比较简单，直接将 src 目录下的文件拷贝到工程中即可，使用方式和自己编写的 .c 和 .h 文件一样
三、API函数
iniparser.h
/* 获取dictionary对象的section个数 */
int iniparser_getnsec(dictionary *d);
/* 获取dictionary对象的第n个section的名字 */
char * iniparser_getsecname(dictionary *d, int n);
/* 保存dictionary对象到file */
void iniparser_dump_ini(dictionary * d, FILE * f);
/* 保存dictionary对象一个section到file */
void iniparser_dumpsection_ini(dictionary * d, char * s, FILE * f);
/* 打印 ini 文件内容 */
void iniparser_dump(dictionary * d, FILE * f);
/* 获取dictionary对象某个section下的key个数 */
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);
/* 返回idictionary对象的section:key对应的整形值 */
int iniparser_getint(dictionary * d, const char * key, int notfound);
/* 返回dictionary对象的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对象并返回(分配内存)dictionary对象 */
dictionary * iniparser_load(const char * ininame);
/* 释放dictionary对象(内存) */
void iniparser_freedict(dictionary * d);
dictionary.h
/* 计算关键词的hash值
unsigned dictionary_hash(const char * key);
/* 创建dictionary对象 */
dictionary * dictionary_new(int size);
/* 删除dictionary对象 */
void dictionary_del(dictionary * vd);
/* 获取dictionary对象的key值 */
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对象 */
void dictionary_dump(dictionary * d, FILE * out);
四、演示
test.ini 文件
#
# 测试文件
#
[Node]
Test = 1234
test.c
#include
#include
#include
#include
#include "iniparser.h"
#define FILE_INI "test.ini"
/**
* @brief 读取 ini 文件的配置信息
*
* @param read_buf 读取缓冲去
* @param return 返回操作结果
*/
int get_ini_info(int *read_buf)
{
dictionary *ini;
ini = iniparser_load(FILE_INI);
if (ini==NULL) {
fprintf(stderr, "cannot parse file: %s\n", FILE_INI);
return -1;
}
/* 打印文件内容 */
// iniparser_dump(ini, stderr);
/* 读取压力等级的判断信息 */
*read_buf = iniparser_getint(ini, "node:test", -1);
iniparser_freedict(ini);
return 0;
}
/**
* @brief 写入 ini 文件的配置信息
*
* @param write_buf 写入缓冲区
* @param return 返回操作结果
*/
int set_ini_info(const char *write_buf)
{
dictionary *ini;
FILE *fp = NULL;
ini = iniparser_load(FILE_INI);
if (ini==NULL) {
fprintf(stderr, "cannot parse file: %s\n", FILE_INI);
return -1;
}
/* 写入压力等级的判断信息 */
iniparser_set(ini, "node:test", write_buf);
/* 将信息保存到文件中 */
fp = fopen(FILE_INI, "w");
if( fp == NULL ) {
fprintf(stderr, "stone:fopen error!\n");
return -1;
}
iniparser_dump_ini(ini, fp);
fclose(fp);
iniparser_freedict(ini);
return 0;
}
int main (int argc, char **argv)
{
int num = 0;
set_ini_info("1234");
get_ini_info(&num);
printf("date is: %d \n", num);
}
文件目录
编译
gcc test.c dictionary.c iniparser.c -o test
测试效果
参考链接
minIni：https://github.com/compuphase/minIni/tree/master/dev
inifile：https://github.com/Winnerhust/inifile2
iniparser：https://github.com/ndevilla/iniparser
Iniparser库详解：https://blog.csdn.net/weixin_46245859/article/details/125860628
Iniparser库详解：https://blog.csdn.net/weixin_46245859/article/details/125860628