# 地图
通用键到通用值的映射。
Map API 非常类似于 JavaScript 的 (MDN (在新窗口中打开)), 不同之处在于,使用不存在的键进行 .get
操作会导致错误,因为无法表示 undefined
。示例
var map = new Map<i32,string>()
// Because `undefined` cannot be represented if a key is not found, this will error:
var str = map.get(1) // ERROR
// The error can be avoided by first making sure that the key exists, so this works:
var str: string | null = map.has(1) ? map.get(1) : null // OK
# 构造函数
- 构造一个新的映射,将类型为
new Map<K,V>()
K
的键映射到类型为V
的值。
# 实例成员
# 字段
- 此映射中当前的键值对数量。
readonly size: i32
# 方法
function clear(): void
清除映射,删除所有键值对。
function delete(key: K): bool
删除对应键的键值对。如果键存在则返回
true
,否则返回false
。function get(key: K): V
获取与指定键对应的值。如果键不存在则会抛出异常,因为在所有情况下都无法表示“未找到”(使用
Map#has
检查)。function has(key: K): bool
测试指定键是否存在。
function keys(): Array<K>
获取此映射中包含的键作为数组,按照插入顺序。这是初步的,因为不支持迭代器。
function set(key: K, value: V): this
设置指定键的值。如果键不存在,则创建一个新的键值对。
function values(): Array<V>
获取此映射中包含的值作为数组,按照插入顺序。这是初步的,因为不支持迭代器。
function toString(): string
返回此映射的字符串表示形式。