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

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

文章目录

一、头文件 cfg.h

二、核心业务 cfg.c

三、主函数

四、执行结果





一、头文件 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__





二、核心业务 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;
}






三、主函数


#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 ;
}







四、执行结果


插入数据 :


image.png


查询数据 :



image.png


目录
相关文章
C语言之考勤模拟系统平台(千行代码)
C语言之考勤模拟系统平台(千行代码)
65 4
【C语言程序设计——文件】文件操作(头歌实践教学平台习题)【合集】
本文介绍了C语言中的文件操作,分为两个关卡。第1关任务是将键盘输入的字符(以#结束)存入`file1.txt`并显示输出;第2关任务是从键盘输入若干行文本(每行不超过80个字符,用-1作为结束标志),写入`file2.txt`后再读取并显示。文中详细讲解了文件的打开、读取(使用`fgetc()`和`fgets()`)、写入(使用`fputc()`和`fputs()`)及关闭操作,并提供了示例代码和测试说明。
31 5
【C语言】文件操作函数详解
C语言提供了一组标准库函数来处理文件操作,这些函数定义在 `<stdio.h>` 头文件中。文件操作包括文件的打开、读写、关闭以及文件属性的查询等。以下是常用文件操作函数的详细讲解,包括函数原型、参数说明、返回值说明、示例代码和表格汇总。
62 9
C 语言中的文件操作:数据持久化的关键桥梁
C语言中的文件操作是实现数据持久化的重要手段,通过 fopen、fclose、fread、fwrite 等函数,可以实现对文件的创建、读写和关闭,构建程序与外部数据存储之间的桥梁。
C 语言递归算法:以简洁代码驾驭复杂逻辑
C语言递归算法简介:通过简洁的代码实现复杂的逻辑处理,递归函数自我调用解决分层问题,高效而优雅。适用于树形结构遍历、数学计算等领域。
C语言物联网开发之设备安全与代码可靠性隐患
物联网设备的C语言代码安全与可靠性至关重要。一是防范代码安全漏洞,包括缓冲区溢出和代码注入风险,通过使用安全函数和严格输入验证来预防。二是提高代码跨平台兼容性,利用`stdint.h`定义统一的数据类型,并通过硬件接口抽象与适配减少平台间的差异,确保程序稳定运行。
C语言中的文件操作技巧,涵盖文件的打开与关闭、读取与写入、文件指针移动及注意事项
本文深入讲解了C语言中的文件操作技巧,涵盖文件的打开与关闭、读取与写入、文件指针移动及注意事项,通过实例演示了文件操作的基本流程,帮助读者掌握这一重要技能,提升程序开发能力。
179 3
C语言因高效灵活被广泛应用于软件开发。本文探讨了优化C语言程序性能的策略,涵盖算法优化、代码结构优化、内存管理优化、编译器优化、数据结构优化、并行计算优化及性能测试与分析七个方面
C语言因高效灵活被广泛应用于软件开发。本文探讨了优化C语言程序性能的策略,涵盖算法优化、代码结构优化、内存管理优化、编译器优化、数据结构优化、并行计算优化及性能测试与分析七个方面,旨在通过综合策略提升程序性能,满足实际需求。
82 1
【c语言】玩转文件操作
本文介绍了C语言中文件操作的基础知识,包括文件的打开和关闭、文件的顺序读写、文件的随机读写以及文件读取结束的判定。详细讲解了`fopen`、`fclose`、`fseek`、`ftell`、`rewind`等函数的使用方法,并通过示例代码展示了如何进行文件的读写操作。最后,还介绍了如何判断文件读取结束的原因,帮助读者更好地理解和应用文件操作技术。
67 2
深入C语言指针,使代码更加灵活(二)
深入C语言指针,使代码更加灵活(二)

热门文章

最新文章

AI助理

你好,我是AI助理

可以解答问题、推荐解决方案等