【Kotlin 入門指南】Map 集合

【Kotlin 入門指南】系列文章目錄：https://bit.ly/3t8awwL

Kotlin 線上課程教學影片：https://bit.ly/3qJ5a5Q

Map 集合

Map 集合，它以 key-value 的方式儲存資料，並確保每個 key 都是獨一無二的。在 Kotlin 中，透過 mapOf 可建立不可變的 Map 集合，這表示一旦初始化資料就無法再做增、刪、改的動作。相對地，使用 MutableMap 則能讓你動態地新增、移除、讀取和修改所有資料。

使用 mapOf 建立不可變 Map 集合

在 Kotlin 中，Map 只能一開始初始資料和事後讀取元素，之後不能進行增、刪、修。

// 建立一個不可變的 Map 集合
val map = mapOf("1" to 666, "2" to 777)
println(map) // 輸出：{1=666, 2=777}

在這個例子中，我們使用 mapOf 函數建立了一個名為 map 的 Map 集合，其中包含了兩組 key-value 對。這裡的 key 分別為 "1" 和 "2"，而對應的 values 則為 666 和 777。

然而，需要注意的是，這樣的 Map 集合在建立後就變成了不可變的，也就是說無法在後續的程式執行中對其進行元素的增加、刪除或修改操作。這是因為我們使用了 val 來宣告這個 Map 集合，使其成為了一個不可變的引用，其內容無法被修改。

若我們嘗試對這樣的不可變 Map 集合進行修改，例如增加一個新的 key-value 對，就會出現編譯錯誤：

// 嘗試修改不可變的 Map 集合，會產生編譯錯誤
map["3"] = 888 // 編譯錯誤：Val cannot be reassigned

在這個範例中，嘗試在不可變的 Map 集合 map 中新增一個 key 為 "3"、value 為 888 的元素，但由於該集合為不可變的，因此編譯器會報錯指出無法重新指派值給不可變變數。

使用 MutableMap 建立可變 Map 集合

若需要事後可以修改，需使用 MutableMap 集合操作新增、移除、讀取、全部刪除資料:

// 建立一個 MutableMap
var mutableMap: MutableMap<String, Int> = mutableMapOf()

// 新增資料
mutableMap["1"] = 666
mutableMap["2"] = 777
mutableMap["3"] = 888

println("新增資料後的集合：$mutableMap")

// 移除資料
mutableMap.remove("1")
println("移除 key 為 \"1\" 後的集合：$mutableMap")

// 獲取資料
val valueForKey2 = mutableMap["2"]
println("key 為 \"2\" 的值：$valueForKey2")

// 刪除所有資料
mutableMap.clear()
println("刪除所有資料後的集合：$mutableMap")

Map 集合常用的方法

- put(key: K, value: V)：新增或更新指定鍵的值。如果鍵不存在，則新增一個鍵值對，否則更新現有的鍵值對。
- putAll(from: Map<out K, V>)：從另一個 Map 中複製所有的鍵值對到目前的 MutableMap 中。
- remove(key: K)：移除指定鍵的鍵值對。
- clear()：清空所有的鍵值對。
- containsKey(key: K)：檢查指定的鍵是否存在於 MutableMap 中。
- containsValue(value: V)：檢查指定的值是否存在於 MutableMap 中。
- getOrDefault(key: K, defaultValue: V)：根據指定的鍵查詢對應的值，如果鍵不存在，則返回預設值。
- getOrElse(key: K, defaultValue: (K) -> V)：根據指定的鍵查詢對應的值，如果鍵不存在，則通過 defaultValue - 函數生成預設值。
- keys：返回包含所有鍵的集合。
- values：返回包含所有值的集合。
- entries：返回包含所有鍵值對的集合。
- isEmpty()：檢查 MutableMap 是否為空。
- size：返回 MutableMap 中鍵值對的數量。