文件与目录
Diese Seite ist in der gewählten Sprache noch nicht verfügbar. Angezeigt wird die englische Dokumentation derselben Version.
Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.
通过 import fs from "std.fs" 导入。相对路径按当前 .ku 源文件所在目录解析,不是按终端当前目录;绝对路径保持绝对路径。
写入、读取与目录列表
“写入、读取与目录列表”章节将下列程序保存为可写目录中的 files.ku,执行 ku run files.ku。程序会在源码旁创建或覆盖 message.txt,结束后可删除该文件。目录列表也会包含源码及该目录内原有文件。
import fs from "std.fs"
fn main(): null! { fs.write("message.txt", "你好 Ku\n")? text = fs.read("message.txt")? println(text) println(fs.exists("message.txt"))
paths = fs.read_dir(".")? for path in paths { println(path) }
try { fs.read("missing.txt")? } catch (err) { println(err.domain) println(err.code) } return ok(null)}程序输出 你好 Ku、true、排序后的条目路径,再为特意读取的缺失文件输出 fs、read_failed。问候文本自带换行,加上 println 会多一个空行。
接口
“接口”章节T! 表示 Result。输入参数为只读;读取结果为独立持有的字符串,目录结果为独立持有的数组。
| 调用 | 返回 | 行为 |
|---|---|---|
fs.read(path:str) |
str! |
读取 UTF-8 文件 |
fs.try_read(path:str) |
str! |
read 的兼容别名 |
fs.write(path:str, text:str) |
null! |
创建或截断文件,写入 UTF-8 文本 |
fs.try_write(path:str, text:str) |
null! |
write 的兼容别名 |
fs.exists(path:str) |
bool | 能读取文件、目录或跟随后有效链接的 metadata 时为 true |
fs.read_dir(path:str) |
[str]! |
读取一层目录,按路径排序返回 |
write 不自动创建父目录、不追加内容,也不承诺原子替换;执行中断时可能已产生部分外部写入。read_dir 不递归,会同时包含文件和目录。返回的是解析后目录与条目名组成的路径,不只是文件名;不表示路径规范化或限制符号链接范围。
exists 对缺失路径、非法或过长路径、metadata 或权限错误返回 false。false 不能唯一判断为文件不存在,true 也不保证随后一定能打开。
限制与错误
“限制与错误”章节| 操作 | 上限 |
|---|---|
read/try_read |
1,000,000 个 UTF-8 字节 |
write/try_write |
1,000,000 个 UTF-8 文本字节 |
read_dir |
10,000 项,返回路径文本合计 1,000,000 字节 |
| 目录与存在性查询路径 | 32,768 字节,包含解析后的目录前缀 |
文件错误的 domain 为 fs,常见 code 为 read_failed、file_too_large、write_failed、content_too_large、read_dir_failed;分配或资源失败可能有对应路径的错误。非法 UTF-8 会报错,不会进行有损转换。try_read/try_write 不改变返回类型,也不会把失败变成默认值。
使用 ? 或示例中的 try/catch 处理错误。本模块目前没有公开的二进制文件、删除、重命名、创建目录或原子写入操作;二进制缓冲见标准库目录。
执行支持
“执行支持”章节六个接口支持解释器、默认打包 runner 和同步 native C。受限 native Task 路径也通过固定容量的后台池支持这些文件和目录操作,调用本身可挂起,无需额外 await。取消不能撤回已经执行的 OS 操作,native Task 在 finally 中不允许提交这类操作。LLVM 不提供完整文件模块。