Skip to content

コレクションの作成 ​

要素から構築する ​

コレクションを作成する最も一般的な方法は、標準ライブラリ関数の listOf<T>()、setOf<T>()、mutableListOf<T>()、mutableSetOf<T>() を使用することです。 コレクションの要素をカンマ区切りのリストとして引数に渡すと、コンパイラは要素の型を自動的に推論します。空のコレクションを作成する場合は、型を明示的に指定してください。

kotlin
val numbersSet = setOf("one", "two", "three", "four")
val emptySet = mutableSetOf<String>()

マップについても、mapOf() および mutableMapOf() 関数で同様のことができます。マップのキーと値は Pair オブジェクトとして渡されます(通常は中置関数 to を使って作成されます)。

kotlin
val numbersMap = mapOf("key1" to 1, "key2" to 2, "key3" to 3, "key4" to 1)

なお、to 表記は一時的な Pair オブジェクトを作成するため、パフォーマンスが重視されない場合にのみ使用することをお勧めします。過剰なメモリ消費を避けるには、代替の方法を使用してください。たとえば、ミュータブルなマップを作成し、書き込み操作を使って要素を追加できます。ここでは、apply() 関数を使用すると初期化を流れるように記述できます。

kotlin
val numbersMap = mutableMapOf<String, String>().apply { this["one"] = "1"; this["two"] = "2" }

コレクションビルダー関数による作成 ​

コレクションを作成するもう1つの方法は、ビルダー関数(buildList()、buildSet()、または buildMap())を呼び出すことです。これらは対応する型の新しいミュータブルなコレクションを作成し、書き込み操作 を使用して要素を追加したうえで、同じ要素を持つ読み取り専用コレクションを返します。

kotlin
val map = buildMap { // これは MutableMap<String, Int> であり、キーと値の型は以下の `put()` の呼び出しから推論されます
    put("a", 1)
    put("b", 0)
    put("c", 4)
}

println(map) // {a=1, b=0, c=4}

空のコレクション ​

要素を持たないコレクションを作成するための関数として、emptyList()、emptySet()、および emptyMap() も用意されています。 空のコレクションを作成するときは、そのコレクションが保持する要素の型を指定する必要があります。

kotlin
val empty = emptyList<String>()

リストの初期化関数 ​

リストには、リストのサイズと、インデックスに基づいて要素の値を定義する初期化関数を受け取る、コンストラクタのような関数があります。

kotlin
fun main() {
    val doubled = List(3, { it * 2 })  // 後で内容を変更したい場合は MutableList
    println(doubled)
}

具体的な型のコンストラクタ ​

ArrayList や LinkedList などの具体的な型のコレクションを作成するには、それらの型で利用可能なコンストラクタを使用できます。同様のコンストラクタは Set や Map の実装でも利用可能です。

kotlin
val linkedList = LinkedList<String>(listOf("one", "two", "three"))
val presizedSet = HashSet<Int>(32)

コピー ​

既存のコレクションと同じ要素を持つコレクションを作成するには、コピー関数を使用できます。標準ライブラリのコレクションコピー関数は、同じ要素への参照を持つ 浅いコピー(shallow copy) のコレクションを作成します。したがって、コレクションの要素に加えられた変更は、そのすべてのコピーに反映されます。

toList()、toMutableList()、toSet() などのコレクションコピー関数は、特定の時点におけるコレクションのスナップショットを作成します。その結果は、同じ要素を持つ新しいコレクションになります。元のコレクションに要素を追加または削除しても、コピーには影響しません。また、コピー側もコピー元とは独立して変更できます。

kotlin
class Person(var name: String)
fun main() {
    val alice = Person("Alice")
    val sourceList = mutableListOf(alice, Person("Bob"))
    val copyList = sourceList.toList()
    sourceList.add(Person("Charles"))
    alice.name = "Alicia"
    println("First item's name is: ${sourceList[0].name} in source and ${copyList[0].name} in copy")
    println("List size is: ${sourceList.size} in source and ${copyList.size} in copy")
}

これらの関数は、リストからセットを作成したり、その逆を行ったりするなど、コレクションを他の型に変換するためにも使用できます。

kotlin
fun main() {
    val sourceList = mutableListOf(1, 2, 3)    
    val copySet = sourceList.toMutableSet()
    copySet.add(3)
    copySet.add(4)    
    println(copySet)
}

あるいは、同じコレクションインスタンスへの新しい参照を作成することもできます。新しい参照は、コレクション変数を既存のコレクションで初期化するときに作成されます。そのため、ある参照を通じてコレクションインスタンスが変更されると、その変更はすべての参照に反映されます。

kotlin
fun main() {
    val sourceList = mutableListOf(1, 2, 3)
    val referenceList = sourceList
    referenceList.add(4)
    println("Source size: ${sourceList.size}")
}

コレクションの初期化は、可変性(mutability)を制限するために使用できます。たとえば、MutableList への List 参照を作成した場合、その参照を通じてコレクションを変更しようとすると、コンパイラはエラーを出力します。

kotlin
fun main() {
    val sourceList = mutableListOf(1, 2, 3)
    val referenceList: List<Int> = sourceList
    //referenceList.add(4)            //コンパイルエラー
    sourceList.add(4)
    println(referenceList) // sourceList の現在の状態を表示
}

他のコレクションに対する関数の呼び出し ​

コレクションは、他のコレクションに対するさまざまな操作の結果として作成することもできます。たとえば、リストのフィルタリングは、フィルタに一致する要素の新しいリストを作成します。

kotlin
fun main() {
    val numbers = listOf("one", "two", "three", "four")  
    val longerThan3 = numbers.filter { it.length > 3 }
    println(longerThan3)
}

マッピングは、変換結果からリストを生成します。

kotlin
fun main() {
    val numbers = setOf(1, 2, 3)
    println(numbers.map { it * 3 })
    println(numbers.mapIndexed { idx, value -> value * idx })
}

関連付け(Association)はマップを生成します。

kotlin
fun main() {
    val numbers = listOf("one", "two", "three", "four")
    println(numbers.associateWith { it.length })
}

Kotlinにおけるコレクション操作の詳細については、コレクション操作の概要を参照してください。