file.h 文档

文件概述

file.h 是一个定义文件操作相关功能的头文件，支持跨平台的文件读写操作。该文件是 libcc 项目的一部分，遵循开源许可证（见文件头部注释）。

主要功能

1. 文件操作结构体

定义了 _cc_file_t 结构体，用于封装文件操作： - size - 获取文件大小。 - seek - 文件指针定位。 - read - 读取文件数据。 - write - 写入文件数据。 - close - 关闭文件。

2. 宏定义

提供了文件操作的宏： - _cc_fopen - 打开文件。 - _cc_fseek - 文件指针定位。 - _cc_fread - 读取文件数据。 - _cc_fwrite - 写入文件数据。 - _cc_fclose - 关闭文件。

3. 函数

提供了函数 _cc_open_file，用于打开文件并返回 _cc_file_t 结构体。

使用示例

示例 1：读取文件内容

#include <libcc/core/file.h>
#include <stdio.h>

int main() {
    _cc_file_t* file = _cc_open_file(_T("example.txt"), _T("r"));
    if (file) {
        char buffer[1024];
        size_t bytes_read = _cc_fread(file, buffer, 1, sizeof(buffer));
        printf("Read %zu bytes: %s\n", bytes_read, buffer);
        _cc_fclose(file);
    }
    return 0;
}

注意事项

1. 跨平台兼容性：支持 Windows 和 Unix 平台。
2. 线程安全：函数是线程安全的。

许可证

该文件遵循开源许可证，详细信息请参考文件头部的注释。