Kotlinでコレクションの要素を変換するmap()の基本と応用例

1. Kotlinのmap()関数とは？

1. Kotlinのmap()関数とは？

Kotlinのmap()関数は、リストや配列などのコレクションの中身を別の形に変換するための基本的な機能です。すべての要素に同じ処理を行い、その結果をまとめた新しいリストを作ることができます。

大きなポイントは、元のリストは一切変更されないという点です。安全にデータを加工できるため、初心者でも安心して使えます。

たとえば「数字をすべて2倍にする」「文字列を加工する」といった処理を、for文を書かずにシンプルに表現できます。

fun main() {
    val numbers = listOf(1, 2, 3)
    val result = numbers.map { it * 2 }
    println(result)
}

この例では、numbersの各要素に対して「2倍する」処理を行い、[2, 4, 6]という新しいリストを作っています。itはリストの中の1つ1つの値を表しており、初心者は「今処理している要素」と考えると理解しやすいです。

2. 具体的な使い方の例

2. 具体的な使い方の例

ここでは、map()関数の動きをイメージしやすいように、数字を2倍にするとてもシンプルな例を使って説明します。プログラミングが初めての方でも、「何が起きているか」を追いながら読める内容です。

まず、numbersというリストには複数の数字が入っています。map()は、そのリストの先頭から順番に1つずつ取り出して、指定した処理を行います。

fun main() {
    val numbers = listOf(1, 2, 3, 4, 5)
    val doubled = numbers.map { it * 2 }
    println(doubled)
}

[2, 4, 6, 8, 10]

map { it * 2 }の中のitは、「今処理している1つの数字」を表しています。1 → 2、2 → 4、3 → 6…というように変換され、結果だけを集めた新しいリストが作られます。

このようにmap()を使うと、「繰り返し処理」と「変換」をまとめて書けるため、コードが短くなり、何をしているのかも分かりやすくなります。

3. map()関数で文字列を変換する

3. map()関数で文字列を変換する

map()は数字だけでなく、文字列のリストを加工したいときにも便利です。たとえば「名前を表示用に整える」「大文字・小文字をそろえる」「末尾に敬称を付ける」など、同じルールでまとめて変換できます。

ここでは分かりやすく、名前のリストをすべて大文字にしてみましょう。文字列の変換でも、流れは数字のときと同じで、1つずつ取り出して処理した結果が新しいリストになります。

fun main() {
    val names = listOf("taro", "hanako", "jiro")
    val upperNames = names.map { it.uppercase() }
    println(upperNames)
}

[TARO, HANAKO, JIRO]

uppercase()は、文字列をすべて大文字に変換するKotlinの関数です。map { it.uppercase() }のitは、リストの中の「今処理している名前」を指します。つまり、"taro" → "TARO"のように順番に変換されます。

fun main() {
    val names = listOf("taro", "hanako", "jiro")
    val withHonorific = names.map { "${it}さん" }
    println(withHonorific)
}

4. map()でオブジェクトのプロパティを取り出す

4. map()でオブジェクトのプロパティを取り出す

map()は、数値や文字列だけでなく、クラス（オブジェクト）のリストにもよく使われます。特に「必要な情報だけを取り出したい」ときにとても便利です。

たとえば、人物データのリストがあり、その中から「名前だけ」「年齢だけ」といった一部のプロパティだけを集めたい場合、map()を使うとシンプルに書けます。

data class Person(val name: String, val age: Int)

fun main() {
    val people = listOf(
        Person("Taro", 20),
        Person("Hanako", 25),
        Person("Jiro", 30)
    )
    val names = people.map { it.name }
    println(names)
}

[Taro, Hanako, Jiro]

ここでのitは、リストの中のPersonオブジェクトを1人ずつ表しています。it.nameと書くことで、「その人の名前」だけを取り出しています。

fun main() {
    val people = listOf(
        Person("Taro", 20),
        Person("Hanako", 25),
        Person("Jiro", 30)
    )
    val ages = people.map { it.age }
    println(ages)
}

5. map()と他の処理を組み合わせる

5. map()と他の処理を組み合わせる

Kotlinではmap()を単体で使うだけでなく、ほかのコレクション操作（filterなど）とつなげて書くことができます。これを使うと、「条件でしぼる → 形を変える」という流れを、上から下へ読むだけで理解できるコードになります。

たとえば「偶数だけを取り出して、それを2倍にする」という処理は、次のように1行でまとめられます。

fun main() {
    val numbers = listOf(1, 2, 3, 4, 5, 6)
    val result = numbers.filter { it % 2 == 0 }.map { it * 2 }
    println(result)
}

[4, 8, 12]

filter()は「条件に合うものだけ残す」関数で、ここではit % 2 == 0（2で割って余りが0＝偶数）だけを残しています。その結果のリストに対して、続けてmap()で2倍しています。

6. map()とmapIndexed()の違いとは？

6. map()とmapIndexed()の違いとは？

さらに応用として、mapIndexed()という関数もあります。これは、各要素の「位置（インデックス）」も使いたいときに便利です。

fun main() {
    val fruits = listOf("apple", "banana", "cherry")
    val labeled = fruits.mapIndexed { index, fruit -> "$index: $fruit" }
    println(labeled)
}

[0: apple, 1: banana, 2: cherry]

mapIndexedでは、最初の引数がインデックス番号、2つ目が要素になります。何番目かを付けて表示したいときなどに便利です。

7. map()関数を使う上での注意点

7. map()関数を使う上での注意点

map()関数は元のリストを変更せず、新しいリストを作るのが基本です。なので、元のデータを壊さずに処理をしたいときにとても安全です。

また、for文を使うよりコードが短くなり、見やすくなります。特に処理が単純な場合、map()を使うことで可読性（読みやすさ）が大きく上がります。

まとめ

まとめ

Kotlinのmap関数は、コレクションを扱ううえで非常に重要な要素であり、要素ごとに変換を加えて新しいリストを生成する操作として、日常的な開発の中で多くの場面で役立ちます。特に、データを加工したり、形を整えたり、必要な値だけを抽出したりする処理はアプリケーションの至るところで発生します。そのため、mapをどのように使うかを理解することは、Kotlinを扱う上での大きな基礎となります。数字を二倍にしたり、文字列を大文字にしたりといった基本的な変換だけでなく、オブジェクトのリストから特定のプロパティを取り出す処理や、filterと組み合わせることでより柔軟なデータ加工もできます。 さらに、mapは元のリストを変更しないという特徴を持つため、安全に変換処理が行える点も大きな強みです。副作用を避けつつ、意図通りの結果に変換できることは、特に複雑なデータを扱うときほど重要になります。また、for文よりも短く、読みやすく書けることが多いため、コード全体の理解がしやすくなる利点もあります。mapを自然に使えるようになると、関数型スタイルでのコーディングがぐっと身近になり、コードの表現力も高まっていきます。 実践的な場面では、mapは単体で使うよりも、filterやmapIndexedなどと組み合わせて処理の流れを整理していくことで本領を発揮します。データを加工しながら分類したり、各要素に番号をつけて整列させたりと、発展的な使い方も豊富です。開発経験を積むほど、mapがどれほど多くの局面で役立つかを実感できるようになるでしょう。そこで、ふり返りとしてmapを活用したサンプルコードを以下に示します。これまでの記事内容で学んだ要素を自然に確認できる構成になっていますので、自分のプロジェクトでも使える形を意識して見てみてください。

ふり返り用サンプルプログラム

data class Product(val name: String, val price: Int)

fun main() {
    val items = listOf(
        Product("apple", 120),
        Product("banana", 90),
        Product("orange", 150)
    )

    val names = items.map { it.name.uppercase() }
    val pricesWithTax = items.map { (it.price * 1.1).toInt() }
    val labelList = items.mapIndexed { index, item -> "${index}番目:${item.name}:${item.price}円" }

    println(names)
    println(pricesWithTax)
    println(labelList)
}

このサンプルでは、mapで文字列を加工したり、金額に税計算を加えたり、mapIndexedで番号付きのラベルに変換したりと、mapの幅広い使い道を一度に確認できる例になっています。特に、日常的な処理でもよく出てくる「数値計算」「ラベル生成」「文字列変換」といった要素が自然に含まれているため、実務でも応用しやすい構造になっています。さらに、mapが元のリストを変更せず、新しい値を返してくれる仕組みのおかげで、変換処理が明確で読みやすく、コードの安全性も高まります。 mapは単純な関数のように見えて、データの流れを整理する強力な道具です。多くの処理を簡潔にまとめられるため、プロジェクトが大きくなるほど、mapの役割はますます大きくなります。今回学んだ内容を基礎として、mapやfilterといった関数を意識的に使い分けることで、より直感的で読みやすいKotlinコードを書けるようになっていきます。ぜひ、今後の実装でもmapの便利さを活かして、わかりやすいコードを意識してみてください。