取得集合部分
Kotlin 標準函式庫包含用於取得集合中部分元素的擴充函式。 這些函式提供了多種為結果集合選取元素的方法:明確列出元素的位置、指定結果的大小等。
切片 (Slice)
slice() 會傳回具有指定索引的集合元素清單。索引可以以區間 (range) 或整數值集合的形式傳入。
fun main() {
val numbers = listOf("one", "two", "three", "four", "five", "six")
println(numbers.slice(1..3))
println(numbers.slice(0..4 step 2))
println(numbers.slice(setOf(3, 5, 0)))
}Take 與 drop
若要從第一個元素開始取得指定數量的元素,請使用 take() 函式。 若要取得最後幾個元素,請使用 takeLast()。 當傳入的數字大於集合大小時,這兩個函式都會傳回整個集合。
若要取得除指定數量的前幾個或後幾個元素之外的所有元素,請分別呼叫 drop() 和 dropLast() 函式。
fun main() {
val numbers = listOf("one", "two", "three", "four", "five", "six")
println(numbers.take(3))
println(numbers.takeLast(3))
println(numbers.drop(1))
println(numbers.dropLast(5))
}你也可以使用述詞 (predicate) 來定義要取得或捨棄的元素數量。 有四個與上述函式相似的函式:
takeWhile()是帶有述詞的take():它會持續取得元素,直到遇到第一個不符合述詞的元素為止(但不包含該元素)。如果集合的第一個元素就不符合述詞,則結果為空。takeLastWhile()與takeLast()相似:它會從集合末尾開始取得符合述詞的元素區間。該區間的第一個元素是最後一個不符合述詞之元素的下一個元素。如果集合的最後一個元素不符合述詞,則結果為空;dropWhile()與帶有相同述詞的takeWhile()相反:它會傳回從第一個不符合述詞的元素開始一直到末尾的所有元素。dropLastWhile()與帶有相同述詞的takeLastWhile()相反:它會傳回從開頭一直到最後一個不符合述詞的元素。
fun main() {
val numbers = listOf("one", "two", "three", "four", "five", "six")
println(numbers.takeWhile { !it.startsWith('f') })
println(numbers.takeLastWhile { it != "three" })
println(numbers.dropWhile { it.length == 3 })
println(numbers.dropLastWhile { it.contains('i') })
}Chunked
若要將集合切分為指定大小的部分,請使用 chunked() 函式。 chunked() 接受單一引數(即分塊的大小),並傳回由指定大小的 List 組成的 List。 第一個分塊從第一個元素開始並包含 size 個元素,第二個分塊包含接下來的 size 個元素,依此類推。最後一個分塊的大小可能會比較小。
fun main() {
val numbers = (0..13).toList()
println(numbers.chunked(3))
}你也可以立即對傳回的分塊套用轉換。 若要這樣做,請在呼叫 chunked() 時以 Lambda 函式形式提供轉換操作。 該 Lambda 引數即為集合的一個分塊。當使用轉換呼叫 chunked() 時,這些分塊是存活期很短的 List,應該直接在該 Lambda 中被使用。
fun main() {
val numbers = (0..13).toList()
println(numbers.chunked(3) { it.sum() }) // `it` 是原始集合的一個分塊
}Windowed
你可以取得給定大小的集合元素的所有可能區間。 用於取得它們的函式稱為 windowed():它會傳回一個元素區間清單,就像透過給定大小的滑動視窗檢視集合時所看到的內容一樣。 與 chunked() 不同,windowed() 會傳回從集合中的每個元素開始的元素區間(視窗)。 所有視窗都會作為單個 List 的元素傳回。
fun main() {
val numbers = listOf("one", "two", "three", "four", "five")
println(numbers.windowed(3))
}windowed() 透過帶有預設值的參數提供了更大的彈性:
step定義兩個相鄰視窗的第一個元素之間的距離。預設值為 1,因此結果包含從所有元素開始的視窗。如果將步長增加到 2,你將只會收到從奇數元素開始的視窗:第一個、第三個,依此類推。partialWindows包含從集合末尾的元素開始、大小較小的視窗。例如,如果你請求三個元素的視窗,則無法為最後兩個元素建置完整的視窗。在這種情況下啟用partialWindows會額外包含大小為 2 和 1 的兩個清單。
最後,你可以立即對傳回的區間套用轉換。 若要這樣做,請在呼叫 windowed() 時以 Lambda 函式形式提供轉換操作。
fun main() {
val numbers = (1..10).toList()
println(numbers.windowed(3, step = 2, partialWindows = true))
println(numbers.windowed(3) { it.sum() })
}若要建置雙元素視窗,有一個單獨的函式——zipWithNext()。 它會建立接收者集合中相鄰元素組成的配對。 請注意,zipWithNext() 不會將集合切分成對;它會為除最後一個元素之外的每個元素建立一個 Pair,因此它對 [1, 2, 3, 4] 的結果是 [[1, 2], [2, 3], [3, 4]],而不是 [[1, 2], [3, 4]]。 zipWithNext() 也可以搭配轉換函式一起呼叫;該函式應接受接收者集合的兩個元素作為引數。
fun main() {
val numbers = listOf("one", "two", "three", "four", "five")
println(numbers.zipWithNext())
println(numbers.zipWithNext() { s1, s2 -> s1.length > s2.length})
}