Skip to content

字符串与终端 ​

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

字符串 ​

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

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

查找与拆行的边界 ​

  • 查找("") 返回 0;不存在的非空目标返回 -1。如果不想处理特殊下标,用 查找索引,再匹配 存在(位置) 和 不存在。
  • 按行切分(): 序列<字符串> 按 LF(\n)分行,移除行尾 CR(\r),结尾的换行不再多产出一个空行。这与 文件读写::读取全部行 保留 CR 的行为不同。
cl
主程序 {
    令 文本 = "甲\r\n乙\r\n";
    令 行 = 文本.按行切分();
    终端::输出行(行.长度());
    终端::输出行(行.获取(0));
}

输出是 2 和「甲」,不会把 \r 当成文本内容返回。

终端 ​

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

读取一行的完整示例见同时处理三个分支。