Kotlinのスコープ関数の戻り値の違いと使い分けを初心者向けに解説！

1. スコープ関数とは？初心者が知っておくべき基本

1. スコープ関数とは？初心者が知っておくべき基本

Kotlinの「スコープ関数（Scope Functions）」とは、特定のオブジェクトに対して「一時的なスコープ（範囲）」を作り、その中でコードを実行するための便利な仕組みです。これを使うことで、変数名を何度も書かずに処理をまとめられるため、コードがスッキリと読みやすくなります。

例えば、「ペン（オブジェクト）」を手に取って、そのペンで「名前を書き（処理1）」、「キャップを閉める（処理2）」という一連の動作を、ひとまとめのグループとして記述できるイメージです。プログラミング未経験の方でも、まずは「特定のモノ（オブジェクト）に集中して、いくつかの作業をまとめて行うための魔法の合図」だと考えてみてください。

これらは非常によく似ていますが、主な違いは「作業のあとで何が返ってくるか（戻り値）」と「オブジェクトをどう呼ぶか」の2点だけです。まずは、実際のシンプルなコードで雰囲気をつかんでみましょう。

fun main() {
    // 1. 普通に書く場合（名前を何度も書く必要がある）
    val name = "kotlin"
    println(name.uppercase())
    println(name.length)

    // 2. スコープ関数（let）を使う場合（スッキリまとまる！）
    "kotlin".let {
        println(it.uppercase())
        println(it.length)
    }
}

このように、スコープ関数を使うと「it」などのキーワードを使って、対象のオブジェクトをスマートに操作できます。それでは、次の章から最も重要な「戻り値の違い」について詳しく解説していきます！

2. スコープ関数の戻り値の違いとは？使い分けの極意

2. スコープ関数の戻り値の違いとは？使い分けの極意

Kotlinのスコープ関数を使いこなす最大のカギは、処理が終わった後に何が手元に残るか、つまり「戻り値」の違いを理解することです。戻り値には大きく分けて2つのパターンがあります。

プログラミング未経験の方でもイメージしやすいよう、具体的なサンプルコードで比較してみましょう。例えば「お弁当の価格を計算する」場合と「お弁当に具材を追加する」場合では、選ぶべき関数が変わります。

fun main() {
    // 1. 「計算結果」を返すパターン (let)
    val priceWithTax = 500.let { 
        it * 1.1 // 最後に計算した「550.0」が戻り値になる
    }
    println("税込価格は ${priceWithTax}円 です")

    // 2. 「自分自身」を返すパターン (apply)
    val lunchBox = mutableListOf("お米").apply {
        this.add("焼き鮭") // 自分自身（リスト）に具材を追加
        this.add("卵焼き") // 戻り値は追加後の「リストそのもの」
    }
    println("お弁当の中身: $lunchBox")
}

このように、「加工した後の"値"が欲しいのか」それとも「加工した"物"そのものが引き続き欲しいのか」という視点を持つと、驚くほどスムーズにコードが書けるようになります。それでは、具体的にそれぞれの関数がどのようなシーンで活躍するのか、詳しく見ていきましょう！

3. letの戻り値と使い方

3. letの戻り値と使い方

letは「何かを加工して使いたい」場面に向いています。戻り値はラムダの最後の式になります。

val result = "kotlin".let {
    it.uppercase()
}
println(result)

KOTLIN

letは加工した結果を取り出すときに便利です。

4. runの戻り値と使い方

4. runの戻り値と使い方

runもletと同じように、最後の式の結果を返します。ただし、thisでオブジェクトにアクセスするのが違いです。

val message = "kotlin".run {
    this.reversed()
}
println(message)

niltok

runはthisがメインなので、クラスの初期化や一括設定にもよく使われます。

5. applyの戻り値と使い方

5. applyの戻り値と使い方

applyは「元のオブジェクトそのもの」が戻り値になります。オブジェクトを設定してから、そのまま戻したいときに使います。

val sb = StringBuilder().apply {
    append("Hello")
    append(", Kotlin")
}
println(sb.toString())

Hello, Kotlin

applyは設定をまとめて書くときに便利です。

6. alsoの戻り値と使い方

6. alsoの戻り値と使い方

alsoもapplyと同じく、元のオブジェクトが戻ってきます。ただし、使い方はletと同じようにitで書きます。

val list = mutableListOf("A", "B").also {
    it.add("C")
}
println(list)

[A, B, C]

alsoは「処理の途中で確認やログを入れたい」ときに向いています。

7. withの戻り値と使い方

7. withの戻り値と使い方

withは少し特殊で、対象のオブジェクトを引数にして、ブロック内はthisで操作します。戻り値は最後の式の結果です。

val length = with("Kotlin") {
    println("文字数は${length}です")
    length
}
println(length)

文字数は6です
6

withは「特定のオブジェクトに対して複数の処理をしたいとき」に使います。

8. 戻り値で使い分けるコツ

8. 戻り値で使い分けるコツ

ここまでのポイントをおさらいしましょう。Kotlinのスコープ関数の使い分けは、「何を返したいか」が大きなポイントです。

• letやrun：処理の結果を返したいとき
• applyやalso：元のオブジェクトを返したいとき
• with：少し特殊だが、処理の結果を返す

たとえば、何かを加工した結果を使いたいならletやrun、オブジェクトの初期設定をしたいならapplyやalsoが合っています。