iniparser库的使用

最新推荐文章于 2025-12-18 01:03:55 发布
原创 最新推荐文章于 2025-12-18 01:03:55 发布 · 5.5k 阅读 · 23 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#iniparser #linux #ini

本文介绍iniparser库，用于解析和修改INI配置文件。文章详细讲解了iniparser和dictionary API，包括读取、设置、删除INI文件的section和key。并通过示例代码展示了如何在Linux上修改INI文件。

iniparser

一、iniparser的概念

iniparser是针对INI文件的解析器。ini文件则是一些系统或者软件的配置文件。iniparser库的API可以对ini文件（配置文件）进行解析、设置、删除等操作。

下载iniparser：
Github:https://github.com/ndevilla/iniparser

主要代码都在src目录下：
在这里插入图片描述
其中dictionary.h里面声明了一些直接解析ini file的API，iniparser.h里面声明了一些提供用户操作的API。iniparser.h里面的API是对dictionary.h 里面API的再次封装。

ini文件基本格式如下所示：

；地址池
[ipaddrpool]
start              =192.168.1.1
end	               =192.168.1.100

[filepath]
leasefile          =/var/dhcplease/dhcpd.leases

;网络接口
[network]
interface          =en1


[opt]
dns1                =8.8.8.8
dns2                =112.112.112.112
t1                  =38
t2                  =23

ini文件的最基本组成单元就是key或者叫property，每个key都有一个名称（name）和对应的值（value），例如：

start = 192.168.1.1

“start” 就是名称name， “192.168.1.1”是对应的值；

我们还可以将多个key归类为一组，即section， 组名定义要独立一行，并用中括号括起来：

[ipaddrpool]
start = 192.168.1.1
end = 192.168.1.100

其中 [ipaddrpool] 就是组名， 组成员有”start“、”end“；

在section声明下的keys都会和该section关联起来。一个section的作用域会在下一个section声明的地方结束，如果没有sectionde 的声明，那么该section的结束地方就是该文件末尾。section是不可以嵌套的。
定位一个key是用section：key来表示的，所以不同section下的key名称是可以相同的。
iniparser库处理名称的时候，会统一换成小写，所以section和property的名称命名是大小写无关的。
需要注意的是，每个组下的key的唯一的不能重复的，但不同组下可以存在相同key。

注释要以分号开头：

；地址池

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

三、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文件：
在这里插入图片描述
原文件里的代码：

；地址池
[ipaddrpool]
start                          = 192.168.1.1
end                            = 192.168.1.100
 
[filepath]
leasefile                      = /var/dhcplease/dhcpd.leases
 
;网络接口
[network]
interface                      = en1
 
[opt]
dns1                           = 8.8.8.8
dns2                           = 8.8.8.8
subnet                         = 255.255.255.0
router                         = 192.168.3.1
domain                         = local
lease                          = 864
t1                             = 432
t2                             = 756

我们用iniparser对这个ini文件进行修改：

/*********************************************************************************
 *      Copyright:  (C) 2020 makun<1394987689@qq.com>
 *                  All rights reserved.
 *
 *       Filename:  iniparser_test.c
 *    Description:  This file 
 *                 
 *        Version:  1.0.0(2020年07月08日)
 *         Author:  makun <1394987689@qq.com>
 *      ChangeLog:  1, Release initial version on "2020年07月08日 21时33分44秒"
 *                 
 ********************************************************************************/

#include <stdio.h>
#include "iniparser.h"
#include "dictionary.h"


#define PATH "/home/makun/iniparser1/config.ini"

int main (int argc, char **argv)
{
    FILE  *fp = NULL  ;
    dictionary *ini= NULL;

    ini = iniparser_load(PATH);

    if( ini ==NULL)
    {
        printf("inipar  failure\n");
        return -1;
    }

    //设置ipaddrpool
    iniparser_set(ini, "ipaddrpool:start", "192.168.0.0");
    iniparser_set(ini, "ipaddrpool:end", "192.168.1.1");

    printf("%s\n", iniparser_getstring(ini, "ipaddrpool:start", "null"));
    printf("%s\n", iniparser_getstring(ini, "ipaddrpool:end", "null"));
    printf("%s\n", iniparser_getstring(ini, "filepath:leasefile", "null"));
    printf("%s\n", iniparser_getstring(ini, "network:interface", "null"));
    printf("%s\n", iniparser_getstring(ini, "opt:dns1", "null"));
    printf("%s\n", iniparser_getstring(ini, "opt:dns2", "null"));
    printf("%s\n", iniparser_getstring(ini, "opt:subnet", "null"));
    printf("%s\n", iniparser_getstring(ini, "opt:router", "null"));
    printf("%s\n", iniparser_getstring(ini, "opt:domain", "null"));
    printf("%s\n", iniparser_getstring(ini, "opt:lease", "null"));
    printf("%s\n", iniparser_getstring(ini, "opt:t1", "null"));
    printf("%s\n", iniparser_getstring(ini, "opt:t2", "null"));


    fp = fopen(PATH, "w");
    if( fp == NULL ) {
        printf("stone:fopen error!\n");
        exit(-1);
    }

    iniparser_dumpsection_ini(ini, "ipaddrpool", fp);
    iniparser_dumpsection_ini(ini, "filepath", fp);
    iniparser_dumpsection_ini(ini, "network", fp);
    iniparser_dumpsection_ini(ini, "opt", fp);
    fclose(fp);

    iniparser_freedict(ini);



    return 0;
}

运行结果：
在这里插入图片描述
在这里插入图片描述
当代码运行结果后，我们把地址池里的ip修改了，当我们再次进入到ini文件里面，发现之前的ini数据发生了改变，不再是之前的那个，如下图

在这里插入图片描述
iniparser我相信通过我以上的知识及代码，大家应该学会了对iniparser库的使用了吧！如果有不懂的，请评论区留言，看到我会回复你，如果有错误的地方，还请你们指正！谢谢！

参考链接;https://blog.youkuaiyun.com/stone8761/article/details/81100747
https://blog.youkuaiyun.com/LANB0/article/details/50718507?utm_medium=distribute.pc_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-4.nonecase&depth_1-utm_source=distribute.pc_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-4.nonecase

makunIT
关注
项目准备二之Iniparser库使用
weixin_43271542的博客
08-27 1020
项目准备二之CJSON使用前言一、Iniparser概念二、Iniparser格式三、Iniparser库API函数3.1 iniparser.h3.2 dictionary.h四、代码演示4.1config.ini4.2 源码4.3 演示效果五、总结 注：本文系湛江市第十七中学星火创客团队及岭南师范学院物联网俱乐部原创部分训练项目，转载请保留声明。 前言 今天是闭关的的第56天，项目已经完成，今天特地抽时间来总结一下这个项目的具体知识点之Iniparser库，主要用于文件解析。 一、Iniparser概念
iniparser】C语言配置文件解析库 — iniparser 的使用
哈米的博客
08-18 1393
iniparser】C语言配置文件解析库 — iniparser 的使用
Iniparser——非常好用的ini文件读写代码
04-19
Iniparser——非常好用的ini文件读写源代码，供大家学习研究
iniparser文件
03-24
iniparser； ini配置文件解析；非常好用
iniparser-3.1.tar.gz
08-04
iniparser-3.1.tar.gz 用C编写，用于解析ini文件
【iniparser】C语言配置文件解析库 — iniparser 的使用
问题不大
08-02 5114
O、简介 C语言配置文件解析库 — iniparser可以方便的对配置文件进行解析、添加、修改、删除等操作。 github地址 iniparser官网 我的优快云下载 配置文件格式： - 注释：iniparser会无视注释，注释以英文分号开头（;这是配置文件注释） - 注释结构：配置文件包含两个基本单元 section 和 key。其中 section 相当于...
【MQTT学习5】Linux下iniparser库的下载和使用
weixin_48487878的博客
07-14 634
1、iniparser库的概念 iniparser是一个C语言库，是针对ini配置文件的开源解析器。ini文件则是一些系统或者软件的配置文件。 iniparser可以对配置文件进行解析、添加、修改、删除等操作。 2、iniparser的安装 1、下载iniparser wget https://codeload.github.com/ndevilla/iniparser/tar.gz/refs/tags/v4.1 -O iniparserv4.1.tar.gz 2、解压 tar -zxvf inipars
【MQTT】iniparser库的安装和使用
叶里生花
01-18 780
iniparser库iniparser库介绍下载库iniparser中的APIdictionary中的一些API测试代码 iniparser库介绍 iniparser是针对INI文件的解析器。ini文件则是一些系统或者软件的配置文件。iniparser库的API可以对ini文件（配置文件）进行解析、设置、删除等操作。 基本组成单元：key 或者 称之为 property， 每个key都有一个名称(name)和对应的值(value)，例如：host = iot-06z00i99uliom9a.mqtt.io
修改配置文件所用的iniparser库
longyongtu13@qq.com
08-01 667
iniparser的下载 我们可以选择从github中直接下载源码 git clone https://github.com/ndevilla/iniparser 源代码代码都在src文件，我们需要用的时候直接拷贝到我们的项目即可。 iniparser的API介绍 dictionary.h里面声明了一些直接解析ini file的API，iniparser.h里面声明了一些提供用户操作的API。iniparser.h里面的API是对dictionary.h里面API的再次封装，以提供用户友好性，所以我们一
INIParser.rar
03-17
Linux下基于INIParse封装，实现INI配置文件读写，网上有很多例子，重点都是读INI文件，写INI文件的内容很少，尤其是需要新创建Section时，有一个小技巧。
Iniparser。C INI文件解析库
09-22
Iniparser。C INI文件解析库. 亲测可用， C/C++ 效率极高， 已经改好， 可以在VC中进行编译， 使用。 下载给好评
IniParser:IniParserС++
03-29
IniParserС++
iniparser:ini文件解析器
03-17
Iniparser 4 我-概述 该模块提供了从C级别解析ini文件的功能。 请参阅HTML格式的完整文档，请使用任何支持HTML的浏览器从该目录打开文件html / index.html。 主要特点 ： 小：4个文件（2个.c和2个.h）内大约1500 sloc 可移植：无依赖关系，用-ansi -pedantic C89编写 完全具有保护性：易于使其成为线程安全的（仅通过互斥体包围库调用） II-建筑项目 在项目的根部进行简单的make就足以编译静态库（即libiniparser.a ）和共享库（即libiniparser.so.0 ）。 您也应该考虑尝试以下规则： make check ：运行单一测试 make example ：编译示例，使用./example/iniexample运行 III-牌照 该软件是根据MIT许可发布的。 有关完整信息，请参见许可 IV-版本 当
iniparser 库的简单使用
桦桦的博客
08-18 1530
文章目录1 iniparser介绍2 ini文件格式3 iniparser.h4 dictionary.h5 常用的几个函数6 测试代码 1 iniparser介绍 iniparser是一个C语言库，是针对INI文件的开源解析器。ini文件则是一些系统或者软件的配置文件。 github地址如下： https://github.com/ndevilla/iniparser 直接git clone 关键的头文件和c文件在src下 2 ini文件格式 我自己定义了一个配置文件,和测试代码 ini文
iniparser 使用教程
最新发布
gitblog_00326的博客
12-18 1122
iniparser 是一个用 C 语言编写的轻量级配置文件解析库，专门用于解析 INI 格式的配置文件。INI 文件是一种常见的配置文件格式，广泛应用于各种软件系统中，用于存储应用程序的设置和参数。iniparser 提供了简洁的 API，可以方便地对配置文件进行解析、添加、修改、删除等操作。 ## 2、项目快速启动 ### 安装 首先，从 GitHub 下载 iniparser 库： `
iniparser库的介绍和简单使用
geiii9的博客
07-25 2559
iniparser的介绍和简单使用
INI file and Iniparser
wq897387的专栏
03-03 3397
ini介绍和开源库应用
C语言开源库iniparser解析ini文件
new9232的博客
04-21 3711
使用 iniparser 库的应用程序可以很方便地读取和解析INI文件中的配置信息，大大简化了对配置文件的处理工作，降低了程序的开发复杂度。由于其开源属性，开发者可以根据自己的需求自由使用、研究和改进该库。
使用iniparser库新建节的方法
09-03
<think> 我们正在讨论的是使用iniparser库来创建新的节（section）。根据之前的引用内容，特别是引用[2]中提到的“4.4 添加和修改数据”部分，以及引用[1]中关于函数`iniparser_set`的介绍，我们可以知道，在iniparser库中，节（section）是通过设置该节下的键（key）来隐式创建的。 具体来说，当我们使用`iniparser_set`函数设置一个键值对时，如果指定的节（section）不存在，那么该节会被自动创建。 函数原型（引用[1]中的4）： ```c void iniparser_set(dictionary * d, const char * key, const char * val); ``` 因此，新建一个节的方法是：使用`iniparser_set`函数，为该节下的任意一个键赋值。这样，该节就会被创建。 例如，假设我们要创建一个名为`[NewSection]`的节，我们可以在这个节下设置一个键值对，比如： ```c iniparser_set(dict, "NewSection:Key", "Value"); ``` 这样，`NewSection`节就会被创建，并且在该节下有一个键`Key`，其值为`Value`。 注意：键的格式必须是`节名:键名`，用冒号分隔。 如果我们只是想要创建一个空的节，那么我们可以设置一个键值对，然后立即删除这个键（使用`iniparser_unset`），但是这样通常没有意义，因为空的节在INI文件中可能不会被保存（根据iniparser的实现，如果节下没有任何键，则该节不会被写入文件）。因此，我们通常至少设置一个键。 示例代码： ```c #include <stdio.h> #include "iniparser.h" int main() { dictionary *dict = dictionary_new(0); // 创建一个空的字典 // 添加一个节和键值对，如果节不存在则创建 iniparser_set(dict, "Network:IP", "192.168.1.1"); iniparser_set(dict, "Network:Port", "8080"); // 创建一个新节，并添加一个键值对 iniparser_set(dict, "NewSection:Key1", "Value1"); // 保存到文件 FILE *ini_file = fopen("config.ini", "w"); if (ini_file) { iniparser_dump_ini(dict, ini_file); fclose(ini_file); } // 释放字典 dictionary_del(dict); return 0; } ``` 运行以上代码，生成的config.ini文件将包含： ``` [Network] IP=192.168.1.1 Port=8080 [NewSection] Key1=Value1 ``` 总结：新建节的方法是使用`iniparser_set`函数设置一个带有新节名的键值对。 §§相关问题§§ 1. 如何用iniparser删除一个节？ 2. iniparser是否支持嵌套节（如[Parent.Child]）？ 3. 如何检查一个节是否存在？ </think> ### 使用 iniparser 库创建新节的方法 在 iniparser 库中，**新建节（section）是通过间接方式实现的**：当设置某个节下的键时，如果该节不存在，库会自动创建新节。核心方法是使用 `iniparser_set` 函数： #### 📌 新建节的标准方法 ```c // 语法格式 iniparser_set(dictionary *dict, "新节名:键名", "键值"); ``` 当 `新节名` 在字典中不存在时，iniparser 会自动创建这个新节并添加指定的键值对。 #### 示例代码 ```c #include <iniparser.h> int main() { dictionary *dict = dictionary_new(0); // 创建空字典 // 创建新节 [Database] iniparser_set(dict, "Database:Host", "localhost"); iniparser_set(dict, "Database:Port", "3306"); // 创建新节 [Logging] iniparser_set(dict, "Logging:Level", "INFO"); // 验证结果 FILE *f = fopen("config.ini", "w"); iniparser_dump_ini(dict, f); // 输出到文件 fclose(f); dictionary_del(dict); // 释放资源 return 0; } ``` #### 输出结果 (config.ini) ```ini [Database] Host=localhost Port=3306 [Logging] Level=INFO ``` #### 💡 关键说明 1. **自动创建机制** iniparser 会在首次设置某个节的键时自动创建该节[^1]。例如： ```c // 自动创建 [Network] 节 iniparser_set(dict, "Network:IP", "192.168.1.1"); ``` 2. **空节处理** iniparser **不支持创建空节**。如果尝试： ```c iniparser_set(dict, "EmptySection:", ""); // 无效操作 ``` 系统会忽略此操作，因为键名格式必须为 `section:key`[^2]。 3. **节名规范** - 支持字母、数字和下划线 - 避免使用特殊字符 (`[]:;=`) - 大小写敏感 #### 🛠 高级技巧：批量创建节 ```c const char *sections[] = {"Network", "Security", "Storage"}; for (int i = 0; i < 3; i++) { char key[50]; // 在每个节下创建默认键 snprintf(key, sizeof(key), "%s:DefaultKey", sections[i]); iniparser_set(dict, key, "init_value"); } ``` #### 验证节是否存在 ```c if (iniparser_find_entry(dict, "SectionName")) { printf("节已存在\n"); } else { iniparser_set(dict, "SectionName:Key", "Value"); // 创建新节 } ```
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值