Skip to content

コレクション ​

プログラミングでは、後で処理するためにデータを構造化してグループ化できると便利です。Kotlinでは、まさにこの目的のためにコレクションを提供しています。

Kotlinには、要素をグループ化するための以下のコレクションがあります:

コレクションの種類説明
リスト(List)順序付けられた要素のコレクション
セット(Set)重複のない一意な(unique)順序付けられていない要素のコレクション
マップ(Map)キーが一意であり、1つの値にのみマッピングされるキーと値のペアのセット

各コレクションの種類には、可変(mutable)または読み取り専用(read-only)のものがあります。

リスト(List) ​

リストは要素が追加された順序で保存し、重複した要素を許可します。

読み取り専用リスト(List)を作成するには、listOf() 関数を使用します。

可変リスト(MutableList)を作成するには、mutableListOf() 関数を使用します。

リストを作成する際、Kotlinは格納される要素の型を推論できます。型を明示的に宣言するには、リスト宣言の後に山括弧 <> で囲んで型を指定します:

kotlin
fun main() { 
    // 読み取り専用リスト
    val readOnlyShapes = listOf("triangle", "square", "circle")
    println(readOnlyShapes)
    // [triangle, square, circle]
    
    // 型を明示的に宣言した可変リスト
    val shapes: MutableList<String> = mutableListOf("triangle", "square", "circle")
    println(shapes)
    // [triangle, square, circle]
}

意図しない変更を防ぐために、可変リストを List に代入して読み取り専用のビューを作成できます:

kotlin
    val shapes: MutableList<String> = mutableListOf("triangle", "square", "circle")
    val shapesLocked: List<String> = shapes

これはキャスト(casting)とも呼ばれます。

リストは順序付けられているため、リスト内の要素にアクセスするにはインデックスアクセス演算子(indexed access operator) [] を使用します:

kotlin
fun main() { 
    val readOnlyShapes = listOf("triangle", "square", "circle")
    println("The first item in the list is: ${readOnlyShapes[0]}")
    // The first item in the list is: triangle
}

リストの最初または最後の要素を取得するには、それぞれ .first() 関数および .last() 関数を使用します:

kotlin
fun main() { 
    val readOnlyShapes = listOf("triangle", "square", "circle")
    println("The first item in the list is: ${readOnlyShapes.first()}")
    // The first item in the list is: triangle
}

.first() 関数および .last() 関数は、拡張関数(extension functions)の例です。オブジェクトに対して拡張関数を呼び出すには、オブジェクトの後にピリオド . を付け、その後に続けて関数名を書きます。

拡張関数の詳細については中級編ツアーで説明します。現時点では、呼び出し方さえ知っていれば十分です。

リスト内の要素数を取得するには、.count() 関数を使用します:

kotlin
fun main() { 
    val readOnlyShapes = listOf("triangle", "square", "circle")
    println("This list has ${readOnlyShapes.count()} items")
    // This list has 3 items
}

要素がリストに含まれているかを確認するには、in 演算子を使用します:

kotlin
fun main() {
    val readOnlyShapes = listOf("triangle", "square", "circle")
    println("circle" in readOnlyShapes)
    // true
}

可変リストに要素を追加または削除するには、それぞれ .add() 関数および .remove() 関数を使用します:

kotlin
fun main() { 
    val shapes: MutableList<String> = mutableListOf("triangle", "square", "circle")
    // リストに "pentagon" を追加
    shapes.add("pentagon") 
    println(shapes)  
    // [triangle, square, circle, pentagon]

    // リストから最初の "pentagon" を削除
    shapes.remove("pentagon") 
    println(shapes)  
    // [triangle, square, circle]
}

セット(Set) ​

リストが順序付けられており重複する要素を許可するのに対し、セットは順序付けられておらず、一意な(unique)要素のみを保持します。

読み取り専用セット(Set)を作成するには、setOf() 関数を使用します。

可変セット(MutableSet)を作成するには、mutableSetOf() 関数を使用します。

セットを作成する際、Kotlinは格納される要素の型を推論できます。型を明示的に宣言するには、セット宣言の後に山括弧 <> で囲んで型を指定します:

kotlin
fun main() {
    // 読み取り専用セット
    val readOnlyFruit = setOf("apple", "banana", "cherry", "cherry")
    // 型を明示的に宣言した可変セット
    val fruit: MutableSet<String> = mutableSetOf("apple", "banana", "cherry", "cherry")
    
    println(readOnlyFruit)
    // [apple, banana, cherry]
}

前の例を見ると、セットには一意な要素のみが含まれるため、重複している "cherry" が除外されていることがわかります。

意図しない変更を防ぐために、可変セットを Set に代入して読み取り専用のビューを作成できます:

kotlin
    val fruit: MutableSet<String> = mutableSetOf("apple", "banana", "cherry", "cherry")
    val fruitLocked: Set<String> = fruit

セットは順序付けられていないため、特定のインデックスにある要素にアクセスすることはできません。

セット内の要素数を取得するには、.count() 関数を使用します:

kotlin
fun main() { 
    val readOnlyFruit = setOf("apple", "banana", "cherry", "cherry")
    println("This set has ${readOnlyFruit.count()} items")
    // This set has 3 items
}

要素がセットに含まれているかを確認するには、in 演算子を使用します:

kotlin
fun main() {
    val readOnlyFruit = setOf("apple", "banana", "cherry", "cherry")
    println("banana" in readOnlyFruit)
    // true
}

可変セットに要素を追加または削除するには、それぞれ .add() 関数および .remove() 関数を使用します:

kotlin
fun main() { 
    val fruit: MutableSet<String> = mutableSetOf("apple", "banana", "cherry", "cherry")
    fruit.add("dragonfruit")    // セットに "dragonfruit" を追加
    println(fruit)              // [apple, banana, cherry, dragonfruit]
    
    fruit.remove("dragonfruit") // セットから "dragonfruit" を削除
    println(fruit)              // [apple, banana, cherry]
}

マップ(Map) ​

マップは要素をキーと値のペアとして保存します。キーを参照することで値にアクセスします。マップはフードメニューのようなものとしてイメージできます。食べたい料理(キー)を見つけることで、その価格(値)を知ることができます。マップは、リストのように数値のインデックスを使わずに値を検索したい場合に便利です。

  • Kotlinが取得したい値を特定できるようにするため、マップ内のすべてのキーは一意でなければなりません。
  • マップ内で値が重複することは許可されています。

読み取り専用マップ(Map)を作成するには、mapOf() 関数を使用します。

可変マップ(MutableMap)を作成するには、mutableMapOf() 関数を使用します。

マップを作成する際、Kotlinは格納される要素の型を推論できます。型を明示的に宣言するには、マップ宣言の後に山括弧 <> で囲んでキーと値の型を指定します。例えば MutableMap<String, Int> のようになります。この場合、キーの型は String で、値の型は Int です。

マップを作成する最も簡単な方法は、各キーとそれに関連する値の間に to を使用することです:

kotlin
fun main() {
    // 読み取り専用マップ
    val readOnlyJuiceMenu = mapOf("apple" to 100, "kiwi" to 190, "orange" to 100)
    println(readOnlyJuiceMenu)
    // {apple=100, kiwi=190, orange=100}

    // 型を明示的に宣言した可変マップ
    val juiceMenu: MutableMap<String, Int> = mutableMapOf("apple" to 100, "kiwi" to 190, "orange" to 100)
    println(juiceMenu)
    // {apple=100, kiwi=190, orange=100}
}

意図しない変更を防ぐために、可変マップを Map に代入して読み取り専用のビューを作成できます:

kotlin
    val juiceMenu: MutableMap<String, Int> = mutableMapOf("apple" to 100, "kiwi" to 190, "orange" to 100)
    val juiceMenuLocked: Map<String, Int> = juiceMenu

マップ内の値にアクセスするには、インデックスアクセス演算子(indexed access operator) [] にキーを指定して使用します:

kotlin
fun main() {
    // 読み取り専用マップ
    val readOnlyJuiceMenu = mapOf("apple" to 100, "kiwi" to 190, "orange" to 100)
    println("The value of apple juice is: ${readOnlyJuiceMenu["apple"]}")
    // The value of apple juice is: 100
}

マップ内に存在しないキーを使ってキーと値のペアにアクセスしようとすると、null 値が返されます:

kotlin
fun main() {
    // 読み取り専用マップ
    val readOnlyJuiceMenu = mapOf("apple" to 100, "kiwi" to 190, "orange" to 100)
    println("The value of pineapple juice is: ${readOnlyJuiceMenu["pineapple"]}")
    // The value of pineapple juice is: null
}

このツアーでは、後ほどNull安全性(Null safety)の章でnull値について詳しく説明します。

インデックスアクセス演算子(indexed access operator) [] を使って、可変マップに要素を追加することもできます:

kotlin
fun main() {
    val juiceMenu: MutableMap<String, Int> = mutableMapOf("apple" to 100, "kiwi" to 190, "orange" to 100)
    juiceMenu["coconut"] = 150 // キー "coconut" と値 150 をマップに追加
    println(juiceMenu)
    // {apple=100, kiwi=190, orange=100, coconut=150}
}

可変マップから要素を削除するには、.remove() 関数を使用します:

kotlin
fun main() {
    val juiceMenu: MutableMap<String, Int> = mutableMapOf("apple" to 100, "kiwi" to 190, "orange" to 100)
    juiceMenu.remove("orange")    // キー "orange" をマップから削除
    println(juiceMenu)
    // {apple=100, kiwi=190}
}

マップ内の要素数を取得するには、.count() 関数を使用します:

kotlin
fun main() {
    // 読み取り専用マップ
    val readOnlyJuiceMenu = mapOf("apple" to 100, "kiwi" to 190, "orange" to 100)
    println("This map has ${readOnlyJuiceMenu.count()} key-value pairs")
    // This map has 3 key-value pairs
}

特定のキーがすでにマップに含まれているかを確認するには、.containsKey() 関数を使用します:

kotlin
fun main() {
    val readOnlyJuiceMenu = mapOf("apple" to 100, "kiwi" to 190, "orange" to 100)
    println(readOnlyJuiceMenu.containsKey("kiwi"))
    // true
}

マップのキーまたは値のコレクションを取得するには、それぞれ keys プロパティおよび values プロパティを使用します:

kotlin
fun main() {
    val readOnlyJuiceMenu = mapOf("apple" to 100, "kiwi" to 190, "orange" to 100)
    println(readOnlyJuiceMenu.keys)
    // [apple, kiwi, orange]
    println(readOnlyJuiceMenu.values)
    // [100, 190, 100]
}

keys および values は、オブジェクトのプロパティ(properties)の例です。オブジェクトのプロパティにアクセスするには、オブジェクトの後にピリオド . を付け、その後に続けてプロパティ名を書きます。

プロパティについては、クラス(Classes)の章で詳しく説明します。現時点のツアーでは、それらにアクセスする方法を知っておくだけで十分です。

キーや値がマップに含まれているかを確認するには、in 演算子を使用します:

kotlin
fun main() {
    val readOnlyJuiceMenu = mapOf("apple" to 100, "kiwi" to 190, "orange" to 100)
    println("orange" in readOnlyJuiceMenu.keys)
    // true
    
    // あるいは、keys プロパティを使用しなくても構いません
    println("orange" in readOnlyJuiceMenu)
    // true
    
    println(200 in readOnlyJuiceMenu.values)
    // false
}

コレクションでできることの詳細については、コレクション(Collections)を参照してください。

基本型とコレクションの管理方法を理解できたので、次はプログラムで使用できる制御フロー(Control flow)について見ていきましょう。

練習問題 ​

2つのリストの合計要素数をカウントする

「緑(green)」の数値のリストと「赤(red)」の数値のリストがあります。合計でいくつの数値があるかを出力するようにコードを完成させてください。

kotlin
// Keep these two lists as they are. Use them in main().
val greenNumbers = listOf(1, 4, 23)
val redNumbers = listOf(17, 2)

fun main() {
    // ここにコードを記述してください
}
解答例 {...}
kotlin
val greenNumbers = listOf(1, 4, 23)
val redNumbers = listOf(17, 2)

fun main() {
    val totalCount = greenNumbers.count() + redNumbers.count()
    println(totalCount)
}
リクエストされたプロトコルがサポートされているか確認する

サーバーによってサポートされているプロトコルのセットがあります。ユーザーが特定のプロトコルの使用を要求しています。リクエストされたプロトコルがサポートされているかどうかを確認するプログラムを完成させてください(isSupported は Boolean 値である必要があります)。

kotlin
fun main() {
    val SUPPORTED = setOf("HTTP", "HTTPS", "FTP")
    val requested = "smtp"
    val isSupported = TODO() // Replace the TODO() function
    println("Support for $requested: $isSupported")
}
ヒント
リクエストされたプロトコルを大文字でチェックしていることを確認してください。これには .uppercase() 関数を活用できます。
解答例 {...}
kotlin
fun main() {
    val SUPPORTED = setOf("HTTP", "HTTPS", "FTP")
    val requested = "smtp"
    val isSupported = requested.uppercase() in SUPPORTED
    println("Support for $requested: $isSupported")
}
マップを使用して数値をスペルアウトする

1から3までの整数を対応する英単語のスペルに関連付けるマップを定義してください。このマップを使用して、与えられた数値をスペルアウトして出力してください。

kotlin
// Replace the empty map. Keep the variable name as number2word.
val number2word: Map<Int, String> = emptyMap()

fun main() {
    val n = 2
    println("$n is spelled as '${number2word[n]}'")
}
解答例 {...}
kotlin
val number2word = mapOf(1 to "one", 2 to "two", 3 to "three")

fun main() {
    val n = 2
    println("$n is spelled as '${number2word[n]}'")
}