Skip to content

文件、环境与时间 ​

系统和时间接口位于工具层,需要显式导入。对文件操作,应处理 I/O 失败;对环境变量,应区分不存在和内容为空;对计时,应选择适合的时钟。

文件 ​

cl
使用 标准库::工具::系统::文件读写::{ 编码, 文件读写 };

主程序 {
    匹配 文件读写::读取全部字符("说明.txt", 编码::UTF8) {
        成功(文本) => 终端::输出(文本);
        失败(错误) => 终端::输出错误行(错误.描述());
    }
}
调用返回类型何时使用
文件读写::读取全部字节(路径: 字符串)结果<序列<字节>, 文件错误>文件包含二进制数据,或不想在读取时按字符处理。
文件读写::读取全部字符(路径: 字符串, 编码值: 编码)结果<字符串, 文件错误>读取 UTF-8 文本。
文件读写::读取全部行(路径: 字符串, 编码值: 编码)结果<序列<字符串>, 文件错误>以换行符拆分文本,不自动删除 CRLF 中的 \r。
文件读写::写入全部字符(路径: 字符串, 内容: 字符串, 编码值: 编码)结果<整数, 文件错误>创建或覆盖文本文件,成功时返回写入的字节数。

字符读写只接受 编码::UTF8,其他枚举变体并不代表已有相应的转码支持。文件错误 包含公开字段 原因、路径 和 种类。路径拼接可单独使用 文件管理::拼接(基路径: 字符串, 子路径: 字符串): 字符串,它来自 标准库::工具::系统::文件管理::文件管理。

环境与命令行 ​

  • 导入 标准库::工具::系统::环境::环境 后,使用 环境::变量(名字: 字符串): 可选<字符串>。不存在是 不存在,空值是 存在("")。
  • 导入 标准库::工具::系统::命令行::命令行 后,使用 命令行::参数(): 序列<字符串> 取得参数序列。

时间 ​

导入 标准库::工具::时间 后,可使用以下关联方法:

  • 时间::当前时间戳(): 整数:Unix 纪元以来的毫秒数。系统时间调整后,后一次读数可能小于前一次。
  • 时间::单调毫秒(): 整数:用两次读数的差值衡量经过的时间,不把单次读数当作日期时间。
  • 时间::世界(毫秒: 整数): 日历时刻 与 时间::本地(毫秒: 整数): 日历时刻:分别按 UTC 和宿主本地时区拆成年、月、日等字段。若要显式声明 日历时刻 类型,另行导入 标准库::工具::时间::日历时刻。