文件
文件读写与目录管理八件套——对标 C++ fstream;中文路径开箱即用。
导入写法CN
导入 文件::{打开文件, 写入文件, 读取文件行, 关闭文件, 文件存在, 创建目录};文件句柄
句柄类型为 空类型*(C 层 FILE*)。打开模式:1=读、2=写(截断)、3=追加。句柄用完须 关闭文件。中文路径在运行时内部按 UTF-8 转宽字符打开(win 实测支持)。
文件句柄.cnCN
导入 文件::{打开文件, 写入文件, 读取文件行, 关闭文件, 文件存在};
函数 主() -> 整32 {
结果<空类型*, 整32> 写口 = 打开文件("笔记.txt", 2);
如果 (写口.正常) {
结果<整64, 整32> 数 = 写入文件(写口.值, "第一行\n第二行\n");
关闭文件(写口.值);
} 否则 { 返回 1; }
结果<空类型*, 整32> 读口 = 打开文件("笔记.txt", 1);
如果 (读口.正常) {
结果<字符串, 整32> 行 = 读取文件行(读口.值);
如果 (行.正常) {
打印行(行.值); // 第一行(行串已含换行)
} 否则 { 返回 2; }
关闭文件(读口.值);
} 否则 { 返回 3; }
打印(文件存在("笔记.txt")); // 真
返回 0;
}输出:第一行 真
打开文件
函数 打开文件(字符串 路径, 整32 模式) -> 结果<空类型*, 整32>
打开文件返回句柄。模式 1=读、2=写(截断)、3=追加。
| 参数 | 类型 | 说明 |
|---|---|---|
路径 | 字符串 | 文件路径(UTF-8,支持中文) |
模式 | 整32 | 1 读 / 2 写(截断)/ 3 追加 |
返回 正常(句柄);打不开 → 错误(错误码.文件)。
主.cnCN
函数 主() -> 整32 {
打印("===== 文件库(Task 6.2)=====");
字符串 路径 = "target/测试文件.txt";
// ==================== 1. 写入文件(模式2=写,截断) ====================
空类型* 写句柄 = 文件::打开文件(路径, 2);
如果 (写句柄 != 无) {
整64 写数量 = 文件::写入文件(写句柄, "你好,文件系统!\n第二行测试\n第三行内容\n");
打印("写入字节数: ", 写数量);
文件::关闭文件(写句柄);
} 否则 {
打印("打开写失败");
}
// ==================== 2. 文件存在 ====================
布尔 存在 = 文件::文件存在(路径);
打印("文件存在: ", 存在); // 1;
// ==================== 3. 读取文件(模式1=读)按行读取 ====================
空类型* 读句柄 = 文件::打开文件(路径, 1);
如果 (读句柄 != 无) {
// 按行读取:第一行(含换行,打印显示内容不含换行符本身)
字符串 第一行 = 文件::读取文件行(读句柄);
如果 (第一行 != 无) {
打印("第一行: ", 第一行);
} 否则 {
打印("读取第一行失败");
}
// 第二行
字符串 第二行 = 文件::读取文件行(读句柄);
如果 (第二行 != 无) {
打印("第二行: ", 第二行);
} 否则 {
打印("读取第二行失败");
}
// 第三行
字符串 第三行 = 文件::读取文件行(读句柄);
如果 (第三行 != 无) {
打印("第三行: ", 第三行);
} 否则 {
打印("读取第三行失败");
}
// EOF 后再次读取:返回 nullptr(EOF 语义)
字符串 第四行 = 文件::读取文件行(读句柄);
如果 (第四行 != 无) {
打印("第四行(不应有): ", 第四行);
} 否则 {
打印("EOF后读取失败");
}
// ==================== 4. 文件大小(UTF-8 字节数) ====================
整64 大小 = 文件::文件大小(读句柄);
打印("文件大小: ", 大小);
文件::关闭文件(读句柄);
} 否则 {
打印("打开读失败");
}
打印("===== 文件库测试完成 =====");
返回 0;
}输出:===== 文件库(Task 6.2)===== 写入字节数: 57 文件存在: 真 第一行: 你好,文件系统! 第二行: 第二行测试 第三行: 第三行内容 EOF后读取失败 文件大小: 57 ===== 文件库测试完成 =====
写入文件
函数 写入文件(空类型* 句柄, 字符串 数据) -> 结果<整64, 整32>
把字符串写入文件(追加到当前写入位置)。
| 参数 | 类型 | 说明 |
|---|---|---|
句柄 | 空类型* | 打开文件 返回的句柄 |
数据 | 字符串 | 要写入的内容 |
返回 正常(写入字节数);失败 → 错误(错误码.文件)。
主.cnCN
函数 主() -> 整32 {
打印("===== 文件库(Task 6.2)=====");
字符串 路径 = "target/测试文件.txt";
// ==================== 1. 写入文件(模式2=写,截断) ====================
空类型* 写句柄 = 文件::打开文件(路径, 2);
如果 (写句柄 != 无) {
整64 写数量 = 文件::写入文件(写句柄, "你好,文件系统!\n第二行测试\n第三行内容\n");
打印("写入字节数: ", 写数量);
文件::关闭文件(写句柄);
} 否则 {
打印("打开写失败");
}
// ==================== 2. 文件存在 ====================
布尔 存在 = 文件::文件存在(路径);
打印("文件存在: ", 存在); // 1;
// ==================== 3. 读取文件(模式1=读)按行读取 ====================
空类型* 读句柄 = 文件::打开文件(路径, 1);
如果 (读句柄 != 无) {
// 按行读取:第一行(含换行,打印显示内容不含换行符本身)
字符串 第一行 = 文件::读取文件行(读句柄);
如果 (第一行 != 无) {
打印("第一行: ", 第一行);
} 否则 {
打印("读取第一行失败");
}
// 第二行
字符串 第二行 = 文件::读取文件行(读句柄);
如果 (第二行 != 无) {
打印("第二行: ", 第二行);
} 否则 {
打印("读取第二行失败");
}
// 第三行
字符串 第三行 = 文件::读取文件行(读句柄);
如果 (第三行 != 无) {
打印("第三行: ", 第三行);
} 否则 {
打印("读取第三行失败");
}
// EOF 后再次读取:返回 nullptr(EOF 语义)
字符串 第四行 = 文件::读取文件行(读句柄);
如果 (第四行 != 无) {
打印("第四行(不应有): ", 第四行);
} 否则 {
打印("EOF后读取失败");
}
// ==================== 4. 文件大小(UTF-8 字节数) ====================
整64 大小 = 文件::文件大小(读句柄);
打印("文件大小: ", 大小);
文件::关闭文件(读句柄);
} 否则 {
打印("打开读失败");
}
打印("===== 文件库测试完成 =====");
返回 0;
}输出:===== 文件库(Task 6.2)===== 写入字节数: 57 文件存在: 真 第一行: 你好,文件系统! 第二行: 第二行测试 第三行: 第三行内容 EOF后读取失败 文件大小: 57 ===== 文件库测试完成 =====
读取文件
函数 读取文件(空类型* 句柄, 字符* 缓冲, 整64 数量) -> 结果<整64, 整32>
按字节块读入调用方缓冲(对标 fread)。适合大文件分块搬运;文本行读取用 读取文件行 更方便。
| 参数 | 类型 | 说明 |
|---|---|---|
句柄 | 空类型* | 文件句柄 |
缓冲 | 字符* | 接收数据的缓冲区 |
数量 | 整64 | 最多读取的字节数 |
返回 正常(实际读取字节);失败 → 错误(错误码.文件)。
主.cnCN
函数 主() -> 整32 {
打印("===== 文件库(Task 6.2)=====");
字符串 路径 = "target/测试文件.txt";
// ==================== 1. 写入文件(模式2=写,截断) ====================
空类型* 写句柄 = 文件::打开文件(路径, 2);
如果 (写句柄 != 无) {
整64 写数量 = 文件::写入文件(写句柄, "你好,文件系统!\n第二行测试\n第三行内容\n");
打印("写入字节数: ", 写数量);
文件::关闭文件(写句柄);
} 否则 {
打印("打开写失败");
}
// ==================== 2. 文件存在 ====================
布尔 存在 = 文件::文件存在(路径);
打印("文件存在: ", 存在); // 1;
// ==================== 3. 读取文件(模式1=读)按行读取 ====================
空类型* 读句柄 = 文件::打开文件(路径, 1);
如果 (读句柄 != 无) {
// 按行读取:第一行(含换行,打印显示内容不含换行符本身)
字符串 第一行 = 文件::读取文件行(读句柄);
如果 (第一行 != 无) {
打印("第一行: ", 第一行);
} 否则 {
打印("读取第一行失败");
}
// 第二行
字符串 第二行 = 文件::读取文件行(读句柄);
如果 (第二行 != 无) {
打印("第二行: ", 第二行);
} 否则 {
打印("读取第二行失败");
}
// 第三行
字符串 第三行 = 文件::读取文件行(读句柄);
如果 (第三行 != 无) {
打印("第三行: ", 第三行);
} 否则 {
打印("读取第三行失败");
}
// EOF 后再次读取:返回 nullptr(EOF 语义)
字符串 第四行 = 文件::读取文件行(读句柄);
如果 (第四行 != 无) {
打印("第四行(不应有): ", 第四行);
} 否则 {
打印("EOF后读取失败");
}
// ==================== 4. 文件大小(UTF-8 字节数) ====================
整64 大小 = 文件::文件大小(读句柄);
打印("文件大小: ", 大小);
文件::关闭文件(读句柄);
} 否则 {
打印("打开读失败");
}
打印("===== 文件库测试完成 =====");
返回 0;
}输出:===== 文件库(Task 6.2)===== 写入字节数: 57 文件存在: 真 第一行: 你好,文件系统! 第二行: 第二行测试 第三行: 第三行内容 EOF后读取失败 文件大小: 57 ===== 文件库测试完成 =====
读取文件行
函数 读取文件行(空类型* 句柄) -> 结果<字符串, 整32>
读一行;文件尾返回错误。返回为拥有型字符串。注意:返回的行串保留行尾换行符——直接输出用 打印行(行.值)(不再追加换行);拼接/比较前可先 字符串修剪。
| 参数 | 类型 | 说明 |
|---|---|---|
句柄 | 空类型* | 文件句柄 |
返回 正常(一行文本)(含行尾换行);文件尾 → 错误(错误码.文件)。
主.cnCN
函数 主() -> 整32 {
打印("===== 文件库(Task 6.2)=====");
字符串 路径 = "target/测试文件.txt";
// ==================== 1. 写入文件(模式2=写,截断) ====================
空类型* 写句柄 = 文件::打开文件(路径, 2);
如果 (写句柄 != 无) {
整64 写数量 = 文件::写入文件(写句柄, "你好,文件系统!\n第二行测试\n第三行内容\n");
打印("写入字节数: ", 写数量);
文件::关闭文件(写句柄);
} 否则 {
打印("打开写失败");
}
// ==================== 2. 文件存在 ====================
布尔 存在 = 文件::文件存在(路径);
打印("文件存在: ", 存在); // 1;
// ==================== 3. 读取文件(模式1=读)按行读取 ====================
空类型* 读句柄 = 文件::打开文件(路径, 1);
如果 (读句柄 != 无) {
// 按行读取:第一行(含换行,打印显示内容不含换行符本身)
字符串 第一行 = 文件::读取文件行(读句柄);
如果 (第一行 != 无) {
打印("第一行: ", 第一行);
} 否则 {
打印("读取第一行失败");
}
// 第二行
字符串 第二行 = 文件::读取文件行(读句柄);
如果 (第二行 != 无) {
打印("第二行: ", 第二行);
} 否则 {
打印("读取第二行失败");
}
// 第三行
字符串 第三行 = 文件::读取文件行(读句柄);
如果 (第三行 != 无) {
打印("第三行: ", 第三行);
} 否则 {
打印("读取第三行失败");
}
// EOF 后再次读取:返回 nullptr(EOF 语义)
字符串 第四行 = 文件::读取文件行(读句柄);
如果 (第四行 != 无) {
打印("第四行(不应有): ", 第四行);
} 否则 {
打印("EOF后读取失败");
}
// ==================== 4. 文件大小(UTF-8 字节数) ====================
整64 大小 = 文件::文件大小(读句柄);
打印("文件大小: ", 大小);
文件::关闭文件(读句柄);
} 否则 {
打印("打开读失败");
}
打印("===== 文件库测试完成 =====");
返回 0;
}输出:===== 文件库(Task 6.2)===== 写入字节数: 57 文件存在: 真 第一行: 你好,文件系统! 第二行: 第二行测试 第三行: 第三行内容 EOF后读取失败 文件大小: 57 ===== 文件库测试完成 =====
文件大小
函数 文件大小(空类型* 句柄) -> 结果<整64, 整32>
查询文件字节数。
| 参数 | 类型 | 说明 |
|---|---|---|
句柄 | 空类型* | 文件句柄 |
返回 正常(字节数);失败 → 错误(错误码.文件)。
主.cnCN
函数 主() -> 整32 {
打印("===== 文件库(Task 6.2)=====");
字符串 路径 = "target/测试文件.txt";
// ==================== 1. 写入文件(模式2=写,截断) ====================
空类型* 写句柄 = 文件::打开文件(路径, 2);
如果 (写句柄 != 无) {
整64 写数量 = 文件::写入文件(写句柄, "你好,文件系统!\n第二行测试\n第三行内容\n");
打印("写入字节数: ", 写数量);
文件::关闭文件(写句柄);
} 否则 {
打印("打开写失败");
}
// ==================== 2. 文件存在 ====================
布尔 存在 = 文件::文件存在(路径);
打印("文件存在: ", 存在); // 1;
// ==================== 3. 读取文件(模式1=读)按行读取 ====================
空类型* 读句柄 = 文件::打开文件(路径, 1);
如果 (读句柄 != 无) {
// 按行读取:第一行(含换行,打印显示内容不含换行符本身)
字符串 第一行 = 文件::读取文件行(读句柄);
如果 (第一行 != 无) {
打印("第一行: ", 第一行);
} 否则 {
打印("读取第一行失败");
}
// 第二行
字符串 第二行 = 文件::读取文件行(读句柄);
如果 (第二行 != 无) {
打印("第二行: ", 第二行);
} 否则 {
打印("读取第二行失败");
}
// 第三行
字符串 第三行 = 文件::读取文件行(读句柄);
如果 (第三行 != 无) {
打印("第三行: ", 第三行);
} 否则 {
打印("读取第三行失败");
}
// EOF 后再次读取:返回 nullptr(EOF 语义)
字符串 第四行 = 文件::读取文件行(读句柄);
如果 (第四行 != 无) {
打印("第四行(不应有): ", 第四行);
} 否则 {
打印("EOF后读取失败");
}
// ==================== 4. 文件大小(UTF-8 字节数) ====================
整64 大小 = 文件::文件大小(读句柄);
打印("文件大小: ", 大小);
文件::关闭文件(读句柄);
} 否则 {
打印("打开读失败");
}
打印("===== 文件库测试完成 =====");
返回 0;
}输出:===== 文件库(Task 6.2)===== 写入字节数: 57 文件存在: 真 第一行: 你好,文件系统! 第二行: 第二行测试 第三行: 第三行内容 EOF后读取失败 文件大小: 57 ===== 文件库测试完成 =====
关闭文件
函数 关闭文件(空类型* 句柄) -> 空类型
关闭句柄并落盘。句柄关闭后不可再用。
| 参数 | 类型 | 说明 |
|---|---|---|
句柄 | 空类型* | 文件句柄 |
主.cnCN
函数 主() -> 整32 {
打印("===== 文件库(Task 6.2)=====");
字符串 路径 = "target/测试文件.txt";
// ==================== 1. 写入文件(模式2=写,截断) ====================
空类型* 写句柄 = 文件::打开文件(路径, 2);
如果 (写句柄 != 无) {
整64 写数量 = 文件::写入文件(写句柄, "你好,文件系统!\n第二行测试\n第三行内容\n");
打印("写入字节数: ", 写数量);
文件::关闭文件(写句柄);
} 否则 {
打印("打开写失败");
}
// ==================== 2. 文件存在 ====================
布尔 存在 = 文件::文件存在(路径);
打印("文件存在: ", 存在); // 1;
// ==================== 3. 读取文件(模式1=读)按行读取 ====================
空类型* 读句柄 = 文件::打开文件(路径, 1);
如果 (读句柄 != 无) {
// 按行读取:第一行(含换行,打印显示内容不含换行符本身)
字符串 第一行 = 文件::读取文件行(读句柄);
如果 (第一行 != 无) {
打印("第一行: ", 第一行);
} 否则 {
打印("读取第一行失败");
}
// 第二行
字符串 第二行 = 文件::读取文件行(读句柄);
如果 (第二行 != 无) {
打印("第二行: ", 第二行);
} 否则 {
打印("读取第二行失败");
}
// 第三行
字符串 第三行 = 文件::读取文件行(读句柄);
如果 (第三行 != 无) {
打印("第三行: ", 第三行);
} 否则 {
打印("读取第三行失败");
}
// EOF 后再次读取:返回 nullptr(EOF 语义)
字符串 第四行 = 文件::读取文件行(读句柄);
如果 (第四行 != 无) {
打印("第四行(不应有): ", 第四行);
} 否则 {
打印("EOF后读取失败");
}
// ==================== 4. 文件大小(UTF-8 字节数) ====================
整64 大小 = 文件::文件大小(读句柄);
打印("文件大小: ", 大小);
文件::关闭文件(读句柄);
} 否则 {
打印("打开读失败");
}
打印("===== 文件库测试完成 =====");
返回 0;
}输出:===== 文件库(Task 6.2)===== 写入字节数: 57 文件存在: 真 第一行: 你好,文件系统! 第二行: 第二行测试 第三行: 第三行内容 EOF后读取失败 文件大小: 57 ===== 文件库测试完成 =====
文件存在
函数 文件存在(字符串 路径) -> 布尔
文件是否存在(不打开,纯查询)。
| 参数 | 类型 | 说明 |
|---|---|---|
路径 | 字符串 | 文件路径 |
返回 存在为真。
主.cnCN
函数 主() -> 整32 {
打印("===== 文件库(Task 6.2)=====");
字符串 路径 = "target/测试文件.txt";
// ==================== 1. 写入文件(模式2=写,截断) ====================
空类型* 写句柄 = 文件::打开文件(路径, 2);
如果 (写句柄 != 无) {
整64 写数量 = 文件::写入文件(写句柄, "你好,文件系统!\n第二行测试\n第三行内容\n");
打印("写入字节数: ", 写数量);
文件::关闭文件(写句柄);
} 否则 {
打印("打开写失败");
}
// ==================== 2. 文件存在 ====================
布尔 存在 = 文件::文件存在(路径);
打印("文件存在: ", 存在); // 1;
// ==================== 3. 读取文件(模式1=读)按行读取 ====================
空类型* 读句柄 = 文件::打开文件(路径, 1);
如果 (读句柄 != 无) {
// 按行读取:第一行(含换行,打印显示内容不含换行符本身)
字符串 第一行 = 文件::读取文件行(读句柄);
如果 (第一行 != 无) {
打印("第一行: ", 第一行);
} 否则 {
打印("读取第一行失败");
}
// 第二行
字符串 第二行 = 文件::读取文件行(读句柄);
如果 (第二行 != 无) {
打印("第二行: ", 第二行);
} 否则 {
打印("读取第二行失败");
}
// 第三行
字符串 第三行 = 文件::读取文件行(读句柄);
如果 (第三行 != 无) {
打印("第三行: ", 第三行);
} 否则 {
打印("读取第三行失败");
}
// EOF 后再次读取:返回 nullptr(EOF 语义)
字符串 第四行 = 文件::读取文件行(读句柄);
如果 (第四行 != 无) {
打印("第四行(不应有): ", 第四行);
} 否则 {
打印("EOF后读取失败");
}
// ==================== 4. 文件大小(UTF-8 字节数) ====================
整64 大小 = 文件::文件大小(读句柄);
打印("文件大小: ", 大小);
文件::关闭文件(读句柄);
} 否则 {
打印("打开读失败");
}
打印("===== 文件库测试完成 =====");
返回 0;
}输出:===== 文件库(Task 6.2)===== 写入字节数: 57 文件存在: 真 第一行: 你好,文件系统! 第二行: 第二行测试 第三行: 第三行内容 EOF后读取失败 文件大小: 57 ===== 文件库测试完成 =====
创建目录
函数 创建目录(字符串 路径) -> 结果<空类型, 整32>
递归创建目录:多层路径一次建齐(如 target/深/层/目录);目录已存在时同样返回正常(幂等)。写文件前用它保证输出目录就位——失败显式返回错误,不静默继续。
| 参数 | 类型 | 说明 |
|---|---|---|
路径 | 字符串 | 目录路径(UTF-8,支持中文;可含不存在的多层父目录) |
返回 正常();路径中段被同名文件占用/权限不足 → 错误(错误码.文件)。
创建目录.cnCN
导入 文件::{创建目录, 打开文件, 写入文件, 关闭文件};
函数 主() -> 整32 {
结果<空类型, 整32> 建 = 创建目录("target/资料/2026");
如果 (!建.正常) { 返回 1; }
结果<空类型*, 整32> 口 = 打开文件("target/资料/2026/笔记.txt", 2);
如果 (!口.正常) { 返回 2; }
结果<整64, 整32> 写数 = 写入文件(口.值, "目录自动创建\n");
关闭文件(口.值);
如果 (!写数.正常) { 返回 3; }
打印("完成");
返回 0;
}输出:完成