切换主题
文件、环境与时间
系统和时间接口位于工具层,需要显式导入。对文件操作,应处理 I/O 失败;对环境变量,应区分不存在和内容为空;对计时,应选择适合的时钟。
文件
cl
使用 标准库::工具::系统::文件读写::{ 编码, 文件读写 };
主程序 {
匹配 文件读写::读取全部字符("说明.txt", 编码::UTF8) {
成功(文本) => 终端::输出(文本);
失败(错误) => 终端::输出错误行(错误.描述());
}
}| 调用 | 返回类型 | 何时使用 |
|---|---|---|
文件读写::读取全部字节(路径: 字符串) | 结果<序列<字节>, 文件错误> | 文件包含二进制数据,或不想在读取时按字符处理。 |
文件读写::读取全部字符(路径: 字符串, 编码值: 编码) | 结果<字符串, 文件错误> | 读取 UTF-8 文本。 |
文件读写::读取全部行(路径: 字符串, 编码值: 编码) | 结果<序列<字符串>, 文件错误> | 以换行符拆分文本,不自动删除 CRLF 中的 \r。 |
文件读写::写入全部字符(路径: 字符串, 内容: 字符串, 编码值: 编码) | 结果<整数, 文件错误> | 创建或覆盖文本文件,成功时返回写入的字节数。 |
字符读写只接受 编码::UTF8,其他枚举变体并不代表已有相应的转码支持。文件错误 包含公开字段 原因、路径 和 种类。路径拼接可单独使用 文件管理::拼接(基路径: 字符串, 子路径: 字符串): 字符串,它来自 标准库::工具::系统::文件管理::文件管理。
读小型文本时可用上面的整文件方法。文件较大且可以分段处理时,使用流式方法:
文件读写::逐行(路径: 字符串, 处理: 方法<字符串, 结果<整数, 文件错误>>, 编码值: 编码): 结果<整数, 文件错误>将文本行交给回调。文件读写::逐块(路径: 字符串, 块大小: 整数, 处理: 方法<序列<字节>, 结果<整数, 文件错误>>): 结果<整数, 文件错误>将字节块交给回调,块大小必须为正。
回调返回 成功(1) 可以继续读取;这个成功载荷只是占位,不参与累计。返回 失败(错误) 会立即停止,读写方法返回同一错误。方法最终的成功值是处理的行数或块数,不是字节数。处理失败的方式见缺失、失败与错误传播。
环境与命令行
- 导入
标准库::工具::系统::环境::环境后,使用环境::变量(名字: 字符串): 可选<字符串>。不存在是不存在,空值是存在("")。 - 导入
标准库::工具::系统::命令行::命令行后,使用命令行::参数(): 序列<字符串>取得参数序列的快照;下标0是程序名,第一个调用方参数从1开始。先检查长度,再按下标访问。
时间
导入 标准库::工具::时间 后,可使用以下关联方法:
时间::当前时间戳(): 整数:Unix 纪元以来的毫秒数。系统时间调整后,后一次读数可能小于前一次。时间::单调毫秒(): 整数:用两次读数的差值衡量经过的时间,不把单次读数当作日期时间。时间::世界(毫秒: 整数): 日历时刻与时间::本地(毫秒: 整数): 日历时刻:分别按 UTC 和宿主本地时区拆成年、月、日等字段。若要显式声明日历时刻类型,另行导入标准库::工具::时间::日历时刻。
cl
使用 标准库::工具::时间;
使用 标准库::工具::时间::日历时刻;
主程序 {
令 时刻: 日历时刻 = 时间::世界(0);
终端::输出行(时刻.年);
终端::输出行(时刻.月);
终端::输出行(时刻.日);
}结果依次为 1970、1、1。这个例子特意用 世界 而非 本地,所以输出不受运行机器时区影响。