コレクション操作の概要
Kotlin標準ライブラリは、コレクションに対する操作を実行するための多種多様な関数を提供しています。これには、要素の取得や追加といったシンプルな操作から、検索、ソート、フィルタリング、変換などのより複雑な操作までが含まれます。
拡張関数とメンバー関数
コレクション操作は、標準ライブラリ内で2つの方法で宣言されています。コレクションインターフェースのメンバー関数と拡張関数です。
メンバー関数は、コレクション型にとって不可欠な操作を定義します。例えば、Collectionにはその空っぽの状態をチェックするためのisEmpty()関数が含まれています。Listには要素へのインデックスアクセス用のget()が含まれています。
コレクションインターフェースの独自の具象化を作成する場合、それらのメンバー関数を実装する必要があります。新しい実装の作成を容易にするため、標準ライブラリのコレクションインターフェースのスケルトン実装を使用してください。AbstractCollection、AbstractList、AbstractSet、AbstractMap、およびそれらの可変版（mutable counterparts）です。
その他のコレクション操作は拡張関数として宣言されています。これらは、フィルタリング、変換、順序付け、およびその他のコレクション処理関数です。
共通の操作
共通の操作は、読み取り専用コレクションと可変コレクションの両方で利用できます。共通の操作は以下のグループに分類されます。
これらのページで説明されている操作は、元のコレクションに影響を与えることなく結果を返します。例えば、フィルタリング操作は、フィルタリング条件に一致するすべての要素を含む_新しいコレクション_を生成します。このような操作の結果は、変数に格納するか、または他の方法、例えば他の関数に渡すなどして使用する必要があります。
fun main() {
val numbers = listOf("one", "two", "three", "four")
numbers.filter { it.length > 3 } // nothing happens with `numbers`, result is lost
println("numbers are still $numbers")
val longerThan3 = numbers.filter { it.length > 3 } // result is stored in `longerThan3`
println("numbers longer than 3 chars are $longerThan3")
}特定のコレクション操作については、_destination_オブジェクトを指定するオプションがあります。destinationは、関数が新しいオブジェクトで結果項目を返す代わりに、それらを付加する可変コレクションです。destinationを使用する操作を実行するために、名前にTo接尾辞を持つ別の関数があります。例えば、filter()の代わりにfilterTo()、またはassociate()の代わりにassociateTo()です。これらの関数は、destinationコレクションを追加のパラメータとして受け取ります。
fun main() {
val numbers = listOf("one", "two", "three", "four")
val filterResults = mutableListOf<String>() //destination object
numbers.filterTo(filterResults) { it.length > 3 }
numbers.filterIndexedTo(filterResults) { index, _ -> index == 0 }
println(filterResults) // contains results of both operations
}利便性のために、これらの関数はdestinationコレクションを返します。そのため、関数呼び出しの対応する引数内で直接作成できます。
fun main() {
val numbers = listOf("one", "two", "three", "four")
// filter numbers right into a new hash set,
// thus eliminating duplicates in the result
val result = numbers.mapTo(HashSet()) { it.length }
println("distinct item lengths are $result")
}destinationを持つ関数は、フィルタリング、関連付け、グループ化、フラット化、およびその他の操作で利用できます。destination操作の完全なリストについては、Kotlinコレクションリファレンスを参照してください。
書き込み操作
可変コレクションの場合、コレクションの状態を変更する_書き込み操作_も存在します。このような操作には、要素の追加、削除、更新が含まれます。書き込み操作は、書き込み操作およびリスト固有の操作とマップ固有の操作の対応するセクションに記載されています。
特定の操作については、同じ操作を実行するための関数のペアがあります。一方は操作をインプレースで適用し、もう一方は結果を別のコレクションとして返します。例えば、sort()は可変コレクションをインプレースでソートするため、その状態が変化します。sorted()は、同じ要素をソートされた順序で含む新しいコレクションを作成します。
fun main() {
val numbers = mutableListOf("one", "two", "three", "four")
val sortedNumbers = numbers.sorted()
println(numbers == sortedNumbers) // false
numbers.sort()
println(numbers == sortedNumbers) // true
}