【C 语言】文件操作 ( 配置文件读写 | 完整代码示例 ) ★

举报
韩曙亮 发表于 2022/01/14 00:50:46 2022/01/14
【摘要】 文章目录 一、头文件 cfg.h二、核心业务 cfg.c三、主函数四、执行结果 一、头文件 cfg.h // 防止多次导入 #ifndef __CFG_H__ #d...





一、头文件 cfg.h



// 防止多次导入
#ifndef __CFG_H__
#define __CFG_H__

// 兼容 C++
#ifdef  __cplusplus
extern "C" {
#endif // __cplusplus

// 定义接口时 , 如果函数形参用作输入数据时 , 可以在形参名很后面添加 /*in*/ 注释
//

// 获取配置项
int read_config_file(char *filename /*in*/, char *key /*in*/, char * value/*in out*/, int * value_len /*out*/);

// 写出 / 更新配置项
int write_or_update_config_file(char *filename /*in*/, char *key /*in*/, char *value/*in*/, int value_len /*in*/);

#ifdef  __cplusplus
}
#endif // __cplusplus

#endif // __CFG_H__

  
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23




二、核心业务 cfg.c



#define _CRT_SECURE_NO_WARNINGS
#include <stdlib.h>
#include <string.h>
#include <stdio.h>

// 每行最长的大小
#define MAX_LINE 256

/**
 * @brief read_config_file 读取配置文件
 * @param filename 文件名
 * @param key      键
 * @param value    值
 * @param value_len 值字符串长度
 * @return
 */
int read_config_file(char *filename /*in*/, char *key /*in*/, char *value/*in out*/, int *value_len /*out*/)
{

    // 返回值
    int ret = 0;

    // 文件指针
    FILE *fp = NULL;

    // 灵活使用的临时指针
    char *p = NULL;

    // 指向 Value 开始位置的指针
    char *start = NULL;

    // 指向 Value 结束位置的指针
    char *end = NULL;

    // 存储配置文件中的一行数据
    char line_buffer[MAX_LINE];

    // 以只读的方式打开文件
    fp = fopen(filename, "r");
    // 如果文件打开失败 , 说明文件不存在 , 直接退出
    if (fp == NULL)
    {
        ret = -1;
        return ret;
    }

    // 逐行遍历 配置文件 中的文本数据
    while (!feof(fp))
    {
        // 清空 line_buffer 中的遗留数据 , 避免被上一次写入的数据干扰
        memset(line_buffer, 0, sizeof(line_buffer));

        // 获取一行数据
        fgets(line_buffer, MAX_LINE, fp);

        // 查找 '=' 字符
        p = strchr(line_buffer, '=');
        // 如果没有找到 '=' 字符 , 则退出 , 继续执行下一次循环
        if (p == NULL)
        {
            continue;
        }

        // 查找 Key 值
        // 如果找到了 Key 关键字 , 则返回的指针 p 指向 Key 关键字出现的首地址中
        p = strstr(line_buffer, key);
        // 如果没有找到 Key 关键字 , 退出执行下一次循环换
        if (p == NULL)
        {
            continue;
        }

        // 越过 Key 关键字 , 从 Key 关键字后面的内容遍历
        p = p + strlen(key);

        // 查找 '=' 字符
        p = strchr(p, '=');
         // 如果没有找到 '=' 字符 , 则退出 , 继续执行下一次循环
        if (p == NULL)
        {
            continue;
        }

        // 越过 '=' 字符 , 从 '=' 字符 后面的内容遍历
        p = p + 1;

        // 获取 Value 起始位置
        for(;;)
        {
            // 去掉开始位置的空格
            if (*p == ' ')
            {
                p ++ ;
            }
            else
            {
                start = p;
                if (*start == '\n')
                {
                    // 进入到该分支 , 说明 Value 值是空的
                    // 直接退出即可
                    goto End;
                }
                break;
            }
        }

        // 获取 Value 结束位置
        // 从 Value 的不为空格的位置开始遍历
        for(;;)
        {
            // 遇到空格或回车 , 说明读取到了最后的位置, 或者换行位置
            if ((*p == ' ' || *p == '\n'))
            {
                break;
            }
            else
            {
                p ++;
            }
        }
        end = p;

        // 通过 间接赋值 设置 Value 值长度
        *value_len = end - start;

        // 通过 间接赋值 设置 Value 值数据内容
        memcpy(value, start, end - start);
    }

End:
    // 关闭文件
    if (fp == NULL)
    {
        fclose(fp);
    }
    return 0;

}


/**
 * @brief write_or_update_config_file 写出或更新配置项
 * 遍历每行数据 , 检查 key 键 是否存在
 * 如果存在 , 就更新对应的 value 值
 * 如果不存在 , 在文件末尾添加该键值对信息
 * 格式为 :
 * key = value
 *
 * @param filename 文件名称
 * @param key 键
 * @param value 值
 * @param value_len 值的长度
 * @return
 */
int write_or_update_config_file(char *filename /*in*/, char *key /*in*/, char * value/*in*/, int value_len /*in*/)
{
    // 返回值
    int ret = 0;

    // 查询配置文件中 Key 是否存在
    int key_exist = 0;

    // 统计的配置文件大小
    int file_length = 0;

    // 文件指针
    FILE *fp = NULL;

    // 存储读取的每一行配置文件信息
    char line_buffer[MAX_LINE];

    // 临时指针
    char *p = NULL;

    // 文件数据缓存区
    char file_buffer[1024 * 4] = {0};

    // 验证指针有效性
    if (filename == NULL || key == NULL || value == NULL)
    {
        ret = -1;
        printf("error : filename == NULL || key == NULL || value == NULL \n");
        goto End;
    }

    // 使用读写方式打开 filename 文件
    fp = fopen(filename, "r+");
    // 如果打开失败 提示失败信息
    if (fp == NULL)
    {
        ret = -2;
        printf("error : fopen \n");
    }

    // 如果文件打开失败 , 说明没有文件
    if (fp == NULL)
    {
        // 以写的方式 , 打开文本文件 , 如果文件不存在 , 则创建文件
        fp = fopen(filename, "w+t");
        // 打开失败 , 直接退出
        if (fp == NULL)
        {
            ret = -3;
            printf("error : fopen \n");
            goto End;
        }
    }

    // 统计文件大小

    // 将文件指针移动到末尾
    fseek(fp, 0L, SEEK_END);

    // 获取当前指针位置 , 当前指针位置就是文件大小
    file_length = ftell(fp);

    // 将文件指针指向开始位置
    fseek(fp, 0L, SEEK_SET);

    // 文件大小不能超过 4K
    if (file_length > 1024 * 4)
    {
        ret = -3;
        printf("File Size More Than 4K\n");
        goto End;
    }


    // 逐行遍历配置文件
    while (!feof(fp))
    {
        // 将 line_buffer 数据清空
        memset(line_buffer, 0, sizeof(line_buffer));

        // 获取 fp 文件的一行数据 , 保存到 line_buffer 数组中 ,  最多获取 MAX_LINE 字节
        p = fgets(line_buffer, MAX_LINE, fp);
        // 如果获取失败 , 则返回 NULL
        // 获取成功 , 返回的是 line_buffer 地址
        if (p == NULL)
        {
            break;
        }

        // 查询 本行字符数组中是否包含 键 Key
        p = strstr(line_buffer, key);
        // 本行不包含 Key , 将数据行 line_buffer
        // 追加拷贝到 file_buffer 数组中
        if (p == NULL)
        {
            strcat(file_buffer, line_buffer);
            continue;
        }
        else
        {
            // 如果 Key 关键字 在本行 , 则使用新的数据替换原来的数据 , 最后拷贝到 file_buffer 中
            // 替换本行数据
            sprintf(line_buffer, "%s = %s\n", key, value);

            // 将替换的数据 , 追加拷贝到 file_buffer 数组中
            strcat(file_buffer, line_buffer);

            // 设置 Key 存在标志位
            key_exist = 1;
        }
    }

    // 如果 Key 关键字不存在 , 直接将数据追加到文件末尾即可
    if (key_exist == 0)
    {
        fprintf(fp, "%s = %s\n", key, value);
    }
    else // 如果 Key 关键字存在 , 则需要重新写出该文件的数据 , 原来的数据直接删除覆盖
    {
        // 先关闭之前的 文件指针
        if (fp != NULL)
        {
            fclose(fp);
            fp = NULL;
        }

        // 重新打开文件
        fp = fopen(filename, "w+t");
        if (fp == NULL)
        {
            ret = -4;
            printf("fopen() err. \n");
            goto End;
        }
        // 将文件的完整数据 , 写出到 fp 中
        // 注意此处的文件数据 , 没有原来的 键值对数据
        // 写入了要更新的键值对数据
        fputs(file_buffer, fp);

        // 也可以使用 fwrite 函数 , 向文件中写出数据
        //fwrite(filebuf, sizeof(char), strlen(filebuf), fp);
    }

End:
    // 关闭文件
    if (fp != NULL)
    {
        fclose(fp);
    }
    return ret;
}

  
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306




三、主函数



#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "cfg.h"

// 配置文件名称
#define CONFIG_FILE_NAME "D:/File/config.ini"

/**
 * @brief show_menu
 * 显示应用操作菜单
 */
void show_menu()
{
    printf("=============================\n");
    printf("1 Write Config File\n");
    printf("2 Read Config File\n");
    printf("0 Quit\n");
    printf("=============================\n");
}

/**
 * @brief read_config
 * 从配置文件中 , 读取配置文件 键值对 信息
 * @return
 */
int read_config()
{
    // 局部变量 返回值 , 用于表示程序状态
    int ret = 0;

    // 读取 的配置项
    // 数组声明会后 , 注意先进行初始化为 0 操作 , 否则其中的数据可能是随机的
    char key[256] = {0};      // Key 键
    char value[256] = {0};    // Value 值

    // 值 Value 的长度
    int value_len = 0;

    // 提示输入 Key 键
    printf("\nPlease Input Key : ");
    // 将 Key 存储到 name 字符串数组中
    scanf("%s", key);

    // 从 D:/File/config.ini 读取 键值对 信息
    ret = read_config_file(CONFIG_FILE_NAME /*in*/, key /*in*/, value/*in*/, &value_len /*out*/);
    if (ret != 0)
    {
        printf("error : read_config : %d \n", ret);
        return ret;
    }

    // 打印查询结果
    printf("Get Value Success , Value = %s \n", value);

}

/**
 * @brief write_update_config
 * 启动 写出 / 更新 配置项 模块 , 执行 写出 / 更新 配置项操作
 * @return
 */
int write_update_config()
{
    // 局部变量 返回值 , 用于表示程序状态
    int ret = 0;

    // 写出 或 更新 的配置项
    // 数组声明会后 , 注意先进行初始化为 0 操作 , 否则其中的数据可能是随机的
    char key[256] = {0};      // Key 键
    char value[256] = {0};    // Value 值

    // 提示输入 Key 键
    printf("\nPlease Input Key : ");
    // 将 Key 存储到 name 字符串数组中
    scanf("%s", key);

    // 提示输入 Value 值
    printf("\nPlease Input Value : ");
    // 将 Value 值 存储到 value 字符串数组中
    scanf("%s", value);

    // 向 D:/File/config.ini 写出或更新 键值对 信息
    ret = write_or_update_config_file(CONFIG_FILE_NAME /*in*/, key /*in*/, value/*in*/,strlen(value) /*in*/);
    // 判定执行中是否出错
    if (ret != 0)
    {
        printf("error : write_or_update_config : %d \n", ret);
        return ret;
    }

    // 打印成功插入的键值对
    printf("Input %s = %s Success !\n", key , value);
    return ret;
}

/**
 * @brief main 主函数入口
 */
void main()
{

    // 用户输入的选项 , 0 退出 , 1 写出配置 , 2 读取配置
    int user_input;

    // 启动无限循环
    for (;;)
    {
        //显示一个菜单
        show_menu();

        // 从命令行接收 int 值 , 作为菜单选择
        scanf("%d", &user_input);

        // 根据用户的不同输入 , 进行不同的操作
        switch (user_input)
        {
            case 1:     // 写出 或 更新配置项
                write_update_config();
                break;

            case 2:     // 读取配置项
                read_config();
                break;

            case 0:      // 退出程序
                exit(0);

            default:     // 无法识别的操作 , 提示错误操作 , 继续
                printf("Input Error !\n");
                break;
        }

    }

    // 执行完毕会后暂停
    system("pause");
    return ;
}


  
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140




四、执行结果



插入数据 :

在这里插入图片描述

查询数据 :

在这里插入图片描述

文章来源: hanshuliang.blog.csdn.net,作者:韩曙亮,版权归原作者所有,如需转载,请联系作者。

原文链接:hanshuliang.blog.csdn.net/article/details/121724340

【版权声明】本文为华为云社区用户转载文章,如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。