Skip to content

容器、可选与结果 ​

按访问方式选择容器:序列<元素类型> 按位置访问,映射<键类型, 值类型> 按键查找,集合<元素类型> 用于成员判断和集合运算。不要把缺失的键、越界的下标和正常查找得到的值混为一谈。

序列 ​

调用返回类型或效果
序列值.长度()返回元素个数,类型为 整数。
序列值.追加(元素: 元素类型)在末尾追加,修改原序列。
序列值.获取(索引: 整数)返回指定位置的 元素类型;应先确认下标有效。
序列值.设置(索引: 整数, 元素值: 元素类型)修改已有下标的元素,不用它追加。
序列值.查找索引(元素: 元素类型)返回 可选<整数>。

映射 ​

调用返回类型或效果
映射值.插入(映射键: 键类型, 映射值: 值类型)写入值。
映射值.获取(映射键: 键类型)返回 值类型,缺键会报错。
映射值.查找(映射键: 键类型)返回 可选<值类型>,让调用方处理缺键。
映射值.按缺省取值(映射键: 键类型, 缺省值: 值类型)缺键时返回调用方给出的默认值,不修改映射。

集合 ​

集合值.添加(元素: 元素类型) 和 集合值.移除(元素: 元素类型) 修改集合;集合值.包含(元素: 元素类型): 逻辑型 检查是否存在。需要组合两个集合时,可用 并集(另一集合: 集合<元素类型>): 集合<元素类型> 或 交集(另一集合: 集合<元素类型>): 集合<元素类型>。

处理缺失和失败 ​

  • 可选<载荷类型> 有 存在(值) 和 不存在。例如,在序列中找不到一个元素,是合法的查找结果,不是系统错误。
  • 结果<成功类型, 失败类型> 有 成功(值) 和 失败(错误)。例如,文件读写失败时需要把路径和原因交给调用方。
  • 优先用 匹配 分别处理两个分支。若用 解包(),先通过 是否存在() 或 是否成功() 确定当前分支。