【Kotlin 入門指南】Set 集合

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

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

Set 集合

Set 集合特性，它沒有特定的排列順序，且內容物件不會重複。使用setOf建立的是不可變集合，這代表一旦建立，內容便無法更動。這種特性在某些情境下非常實用，尤其是當你需要確保程式執行期間集合的元素保持不變時。相對於不可變集合，MutableSet讓我們能夠對集合進行更動。當需要動態操作集合元素時，MutableSet提供了彈性，讓我們新增、刪除或更新集合中的元素。

setOf 不可變的集合範例

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

var set = setOf(666,777,888)
println(set)

這意味著，當你創建了這個集合後，它的內容是固定的，無法再加入新的元素或者從中移除元素。但你可以隨時讀取其中的元素，例如使用 println(set) 這樣的方式來輸出集合的內容。

不可變的集合在某些情況下非常有用，特別是當你希望在程式執行期間避免對集合進行更改時。它確保了在使用過程中集合的內容保持不變。

MutableSet 可變的集合範例

在 Kotlin 中，使用 MutableSet 集合操作新增、移除、讀取、全部刪除資料:

var mutableSet: MutableSet<Int> = mutableSetOf()

//新增資料
mutableSet.add(666)
mutableSet.add(777)
mutableSet.add(888)
println(mutableSet) // 輸出：[666, 777, 888]

//移除資料
mutableSet.remove(666)
println(mutableSet) // 輸出：[777, 888]

//判斷元素，是否包含在 Set 集合內
println(mutableSet.contains(666)) // 輸出：false

//清除所有資料
mutableSet.clear()
println(mutableSet) // 輸出：[]

在這個範例中，我們建立了一個空的可變集合，指定了元素的類型為整數。 接著，利用 add() 函數向這個可變集合中加入資料。舉例來說，我們新增了數字 666、777 和 888。 若想要從集合中移除特定的元素，可以使用 remove() 函數。這裡我們移除了數字 666。使用 contains() 函數可以檢查特定元素是否存在於集合中。 若需要一次性清除整個集合中的所有資料，可以使用 clear() 函數。

Set 集合常用的方法

- add(element: E)：向集合中新增一個元素，返回一個布林值，表示是否新增成功。
- addAll(elements: Collection<E>)：向集合中新增一組元素。
- remove(element: E)：從集合中刪除一個元素，返回一個布林值，表示是否刪除成功。
- removeAll(elements: Collection<E>)：從集合中刪除一組元素。
- retainAll(elements: Collection<E>)：從集合中保留與給定集合相同的元素，刪除其他元素。
- clear()：清空集合中的所有元素。
- contains(element: E)：判斷集合中是否包含給定的元素，返回一個布林值。
- containsAll(elements: Collection<E>)：判斷集合中是否包含給定集合中的所有元素，返回一個布林值。
- isEmpty()：判斷集合是否為空，返回一個布林值。
- size：返回集合中元素的數量。
- iterator()：返回集合的迭代器，可以用於遍歷集合中的元素。
- forEach(action: (E) -> Unit)：對集合中的每個元素執行給定的操作。
- filter(predicate: (E) -> Boolean)：過濾集合中符合給定條件的元素，返回一個新的集合。
- map(transform: (E) -> R)：將集合中的元素轉換為另一種類型，返回一個新的集合。
- toSet()：將集合轉換為不可變的 Set。
- toList()：將集合轉換為不可變的 List。
- toMutableList()：將集合轉換為可變的 List。
- toTypedArray()：將集合轉換為數組。