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