iniparser库使用

.ini 文件是一种配置文件格式，通常用于存储软件的配置信息。它的名称来源于“initialization”（初始化），常见于Windows操作系统，但也被其他平台和应用程序广泛使用。

内容结构

.ini 文件的内容通常由以下几个部分组成：

1. 节（Section）：用方括号括起的部分，用来分类配置项。
2. 键值对（Key-Value Pair）：在节内，每行表示一个配置项，格式为 key=value。
3. 注释（Comment）：用来添加说明或注释，通常以分号（;）或井号（#）开头。

示例

以下是一个典型的 .ini 文件示例：

ini; 这是一个注释
# 这也是一个注释

[General]
username=jeffrey
website=blog.jeffrey.fun

[Settings]
theme=dark
autosave=true
timeout=30

[Paths]
home_dir=/home/jeffrey
temp_dir=/tmp

详细解释

• 注释：第一行和第二行是注释，分别以 ; 和 # 开头。
• 节：
  • [General]：这是一个节的名称，可以理解为一个分类。
  • [Settings] 和 [Paths]：其他两个节。
• 键值对：
  • 在 [General] 节中，有两个键值对 username=jeffrey 和 website=blog.jeffrey.fun。
  • 在 [Settings] 节中，有三个键值对 theme=dark、autosave=true 和 timeout=30。
  • 在 [Paths] 节中，有两个键值对 home_dir=/home/jeffrey 和 temp_dir=/tmp。

注意事项

• 空行：空行通常会被忽略，但可以用于提高文件的可读性。
• 大小写：节名和键名通常不区分大小写，但这取决于解析器的实现。
• 空格：键和值之间的空格通常会被忽略，但为了保持一致性，最好避免在等号两边添加多余的空格。

.ini 文件格式简单明了，易于阅读和编辑，因而在各种应用程序中被广泛使用。

使用iniparser库读写ini文件

步骤

1. 安装 iniparser 库：首先，需要安装 iniparser 库。可以从 iniparser GitHub 仓库 下载。
2. 创建 example.ini 文件：将你的配置文件内容保存为 example.ini。
3. 编写 C 代码：使用 iniparser 库读取、修改并打印配置文件内容。

example.ini 文件内容

[General]
username=jeffrey
website=blog.jeffrey.fun

[Settings]
theme=dark
autosave=true
timeout=30

[Paths]
home_dir=/home/jeffrey
temp_dir=/tmp

示例 C 代码

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

void print_ini_file(dictionary *ini) {
    if (ini == NULL) {
        printf("Cannot print NULL ini dictionary\n");
        return;
    }

    dictionary_dump(ini, stdout);
}

int main() {
    const char *ini_file = "example.ini";

    // 读取 ini 文件
    dictionary *ini = iniparser_load(ini_file);
    if (ini == NULL) {
        fprintf(stderr, "cannot parse file: %s\n", ini_file);
        return -1;
    }

    // 打印原始 ini 文件内容
    printf("Original ini file content:\n");
    print_ini_file(ini);

    // 修改配置项
    iniparser_set(ini, "General:username", "new_username");
    iniparser_set(ini, "Settings:timeout", "60");
    iniparser_set(ini, "Paths:temp_dir", "/new/tmp");

    // 将修改后的内容写回文件
    FILE *file = fopen(ini_file, "w");
    if (file == NULL) {
        fprintf(stderr, "cannot open file: %s\n", ini_file);
        iniparser_freedict(ini);
        return -1;
    }
    iniparser_dump_ini(ini, file);
    fclose(file);

    // 重新读取并打印修改后的 ini 文件内容
    dictionary *new_ini = iniparser_load(ini_file);
    if (new_ini == NULL) {
        fprintf(stderr, "cannot parse file: %s\n", ini_file);
        iniparser_freedict(ini);
        return -1;
    }

    printf("\nModified ini file content:\n");
    print_ini_file(new_ini);

    // 释放内存
    iniparser_freedict(ini);
    iniparser_freedict(new_ini);

    return 0;
}

编译和运行

确保你已经编译并安装了 iniparser 库，然后使用以下命令编译和运行上面的 C 代码：

gcc -o ini_example ini_example.c -liniparser
./ini_example

输出示例

Original ini file content:
[General]
username = jeffrey
website = blog.jeffrey.fun

[Settings]
theme = dark
autosave = true
timeout = 30

[Paths]
home_dir = /home/jeffrey
temp_dir = /tmp

Modified ini file content:
[General]
username = new_username
website = blog.jeffrey.fun

[Settings]
theme = dark
autosave = true
timeout = 60

[Paths]
home_dir = /home/jeffrey
temp_dir = /new/tmp

说明

• iniparser_load：读取并解析 .ini 文件。
• iniparser_set：修改配置项。
• iniparser_dump_ini：将修改后的内容写回文件。
• dictionary_dump：打印字典内容。
• iniparser_freedict：释放字典所占用的内存。