Skip to content

字符串与终端 ​

字符串 与 终端 是核心层类型。字符串以 UTF-8 存储,字符位置按 Unicode 码点计算,不按 UTF-8 字节或用户感知到的字形计算。要处理原始字节,应先转换为 序列<字节>。

字符串 ​

调用返回类型行为
文本.长度()整数返回码点数。
文本.查找(目标: 字符串)整数返回首次匹配的起始下标;找不到时为 -1。
文本.查找索引(目标: 字符串)可选<整数>匹配时为 存在(位置),找不到时为 不存在。
文本.分割(分隔符: 字符串)序列<字符串>按指定分隔符拆分。
文本.转字符序列()序列<字符>返回文本的码点序列。
文本.转字节()序列<字节>返回 UTF-8 字节序列。
字符串::从字节序列(字节序列: 序列<字节>)结果<字符串, 字符串>解码 UTF-8;非法序列返回失败,报告从 0 开始的字节位置。
cl
主程序 {
    令 文本 = "程令";
    终端::输出行(文本.长度());
    终端::输出行(文本.转字节().长度());
}

两行分别是 2 和 6。用字节偏移切出的数据不能直接当作合法文本,因为它可能恰好截断一个码点。

终端 ​

  • 终端::输出(内容)、终端::输出行(内容) 写到标准输出,后者追加换行。两者的参数类型须满足 可描述。
  • 终端::输出错误行(内容) 写到标准错误并换行;程序可把诊断与正常输出分开。
  • 终端::读取行(): 结果<可选<字符串>, 输入错误> 区分三种情况:成功(存在(文本)) 是读到一行,成功(不存在) 是输入结束,失败(错误) 是读取失败。空行仍是一行,不等于输入结束。
  • 终端::读取全部(): 结果<字符串, 输入错误> 读到输入结束,空输入返回 成功("")。此调用不保证可用于预编译单元,请以当前工具链给出的诊断为准。