CN·语言

文件

文件读写与目录管理八件套——对标 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,支持中文)
模式整321 读 / 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;
}

输出:完成