Map<K, V>

將 K 類型的鍵映射到 V 類型值的鍵值存儲。

種類: object

靜態方法

new

Map.new(): const Map<K, V>

Creates a new empty map of the specified key and value types.

返回: const Map<K, V>

方法

clear

Map.clear(id: Map<K, V>)

清空給定地圖中的所有條目。

參數

名稱	類型	預設值	說明
id	Map<K, V>		地圖要清晰。

---

contains

Map.contains(id: Map<K, V>, key: K): bool

檢查給定映射中是否存在指定的鍵。如果找到該鍵，則傳回 true，否則傳回 false。

參數

名稱	類型	預設值	說明
id	Map<K, V>		要搜索的地圖。
key	K		檢查是否存在的關鍵。

返回: bool

---

copy

Map.copy(id: Map<K, V>): Map<K, V>

創建給定 map 的複本並傳回新映射。

參數

名稱	類型	預設值	說明
id	Map<K, V>		要複製的地圖。

返回: Map<K, V>

---

get

Map.get(id: Map<K, V>, key: K): V

檢索與給定映射中指定鍵關聯的值，如果該鍵不存在，則傳回 na。

參數

名稱	類型	預設值	說明
id	Map<K, V>		要從中檢索值的映射。
key	K		關鍵是在地圖上查找。

返回: V — 與 key 關聯的值，如果鍵不存在，則與 na 關聯。

---

keys

Map.keys(id: Map<K, V>): Array<K>

傳回一個陣列，其中包含給定映射中存在的所有鍵。

參數

名稱	類型	預設值	說明
id	Map<K, V>		從中獲取鑰匙的地圖。

返回: Array<K>

---

put

Map.put(id: Map<K, V>, key: K, value: V): V

插入或更新與給定映射中指定鍵關聯的值。如果該鍵存在，則傳回先前的值；如果是新條目，則傳回 na。

參數

名稱	類型	預設值	說明
id	Map<K, V>		要在其中插入或更新值的映射。
key	K		與值關聯的鍵。
value	V		要插入或更新的值。

返回: V — 與 key 或 na 關聯的先前值（如果該鍵先前不存在）。

---

put_all

Map.put_all(id: Map<K, V>, id2: Map<K, V>)

將所有鍵值對從源映射覆制到目標映射。目標映射中的現有鍵將使用源映射中的值進行更新。

參數

名稱	類型	預設值	說明
id	Map<K, V>		將值複製到的目標映射。
id2	Map<K, V>		要從中複製值的源映射。

---

remove

Map.remove(id: Map<K, V>, key: K): V

從給定映射中刪除與指定鍵關聯的條目。如果該鍵存在，則傳回刪除的值；如果未找到該鍵，則傳回 na。

參數

名稱	類型	預設值	說明
id	Map<K, V>		要從中刪除值的映射。
key	K		要刪除的條目的鍵。

返回: V — 刪除的值，或者 na 如果未找到密鑰。

---

size

Map.size(id: Map<K, V>): int

傳回當前存儲在給定映射中的鍵值對的數量。

參數

名稱	類型	預設值	說明
id	Map<K, V>		要獲取其大小的地圖。

返回: int

---

values

Map.values(id: Map<K, V>): Array<V>

傳回一個包含給定映射中存在的所有值的陣列。

參數

名稱	類型	預設值	說明
id	Map<K, V>		從中獲取值的地圖。

返回: Array<V>