切换主题
容器、可选与结果
按访问方式选择容器:序列<元素类型> 按位置访问,映射<键类型, 值类型> 按键查找,集合<元素类型> 用于成员判断和集合运算。不要把缺失的键、越界的下标和正常查找得到的值混为一谈。
序列
| 调用 | 返回类型或效果 |
|---|---|
序列值.长度() | 返回元素个数,类型为 整数。 |
序列值.追加(元素: 元素类型) | 在末尾追加,修改原序列。 |
序列值.获取(索引: 整数) | 返回指定位置的 元素类型;应先确认下标有效。 |
序列值.设置(索引: 整数, 元素值: 元素类型) | 修改已有下标的元素,不用它追加。 |
序列值.查找索引(元素: 元素类型) | 返回 可选<整数>。 |
映射
| 调用 | 返回类型或效果 |
|---|---|
映射值.插入(映射键: 键类型, 映射值: 值类型) | 写入值。 |
映射值.获取(映射键: 键类型) | 返回 值类型,缺键会报错。 |
映射值.查找(映射键: 键类型) | 返回 可选<值类型>,让调用方处理缺键。 |
映射值.按缺省取值(映射键: 键类型, 缺省值: 值类型) | 缺键时返回调用方给出的默认值,不修改映射。 |
集合
集合值.添加(元素: 元素类型) 和 集合值.移除(元素: 元素类型) 修改集合;集合值.包含(元素: 元素类型): 逻辑型 检查是否存在。需要组合两个集合时,可用 并集(另一集合: 集合<元素类型>): 集合<元素类型> 或 交集(另一集合: 集合<元素类型>): 集合<元素类型>。
处理缺失和失败
可选<载荷类型>有存在(值)和不存在。例如,在序列中找不到一个元素,是合法的查找结果,不是系统错误。结果<成功类型, 失败类型>有成功(值)和失败(错误)。例如,文件读写失败时需要把路径和原因交给调用方。- 优先用
匹配分别处理两个分支。若用解包(),先通过是否存在()或是否成功()确定当前分支。