Kotlinのスコープ関数の種類と使い方を完全解説！初心者でもわかるlet・apply・run・also・withの違い

Kotlinのスコープ関数の種類と使い方（let・apply・run・also・with）

先生と生徒の会話形式で理解しよう

生徒

「Kotlinでletとかapplyとか、いろんな関数が出てくるんですが、違いがよく分かりません…」

先生

「それはスコープ関数と呼ばれるもので、便利だけど最初はややこしいですよね。でも安心してください。使い方と違いを、しっかり整理してお話ししましょう！」

生徒

「それぞれ、どんなときに使えばいいのかも知りたいです！」

先生

「もちろん！今回はlet・apply・run・also・withの５つを例付きで紹介しますね。」

1. Kotlinのスコープ関数とは？

スコープ関数とは、Kotlinでオブジェクトや変数に対して一時的に処理をまとめたい場合に使用する関数のことです。主にオブジェクトの初期化や値のチェック、処理のチェーンなどで役立ちます。例えば、「このデータに対して何か処理をしたい」「このオブジェクトを簡潔に初期化したい」という場面で使われます。

スコープ関数には以下の5種類があり、それぞれに特徴があります。

let: 主に値を処理する際やnullチェックを行いたいときに使用
apply: オブジェクトを作成してすぐに設定したいときに使用
run: 処理を行って結果を返したいときに使用
also: 処理の副作用（例えばログ出力など）を扱いたいときに使用
with: オブジェクトに対して複数の処理をまとめて実行したいときに使用

それぞれ似ているようで、微妙に使い分けが必要です。例えば、applyとwithは初期化処理に関連していますが、applyはオブジェクト自身を返し、withはラムダの結果を返します。これらを適切に使い分けることで、コードがさらに簡潔で読みやすくなります。

2. let関数：データを一時的に使いたいとき

let関数は、Kotlinにおいて変数の中身を安全に操作したいときに非常に便利な関数です。この関数は、変数の値がnullでない場合にのみ実行され、itという名前で変数を扱います。特に、nullable型（nullを許容する型）の変数に対して、nullチェックを明示的に行うことなく簡潔に処理を記述できるため、コードがスッキリと読みやすくなります。

例えば、以下のように使用します。変数nameがnullでない場合に、名前の長さを表示する処理を行います。


val name: String? = "さくら"
name?.let {
    println("名前の長さは ${it.length} 文字です")
}


名前の長さは 3 文字です

このコードでは、nameがnullでない場合のみ、let関数内の処理が実行されます。もしnameがnullの場合、何も表示されません。

let関数の大きな利点は、nullチェックをより簡潔に書けることです。たとえば、if (name != null)という冗長なチェックをせずに、直接letを使うことで、可読性と保守性が向上します。特に、letを使用することで、変数がnullでない場合にのみ処理を行うという場面でコードの簡素化が図れるため、Kotlinでの開発ではよく利用される手法です。

このように、let関数は、データを一時的に使いたいときや、nullチェックを効率的に行いたいときに最適な選択肢となります。

3. apply関数：初期化処理に最適

apply関数は、オブジェクトを作ってすぐに設定したいときに使います。中ではthisでそのオブジェクトを表します。


val user = StringBuilder().apply {
    append("こんにちは")
    append(" Kotlin")
}
println(user.toString())


こんにちは Kotlin

何かを作って、そのまま設定して、そのまま使うようなときに便利です。

4. run関数：値を戻したいときに

run関数は、applyに似ていますが最後に何かの値を返したいときに使われます。


val length = "Kotlin".run {
    println("中身は：$this")
    this.length
}
println("文字数は：$length")


中身は：Kotlin
文字数は：6

値を作って、その値をそのまま使いたいというケースで使われます。

5. also関数：ログや確認に便利

also関数は、変数を使う前に何かチェックやログ出力をしたいときに使います。中身はitで扱います。


val result = "Kotlin".also {
    println("文字列：$it を使います")
}.uppercase()
println(result)


文字列：Kotlin を使います
KOTLIN

元の値をそのまま戻すので、途中で挙動を見たいときに向いています。

6. with関数：対象がnullじゃないときにまとめて処理

with関数は、nullじゃないオブジェクトに対して、まとめて処理をしたいときに使われます。applyと似ていますが、withは引数でオブジェクトを渡します。


val message = with(StringBuilder()) {
    append("Hello, ")
    append("World!")
    toString()
}
println(message)


Hello, World!

複数の処理を１つにまとめたいときに使うのがポイントです。

Kotlinを基礎からしっかり学びたい人や、 Java経験を活かしてモダンな言語にステップアップしたい人には、定番の入門書がこちらです。

基礎からわかるKotlinをAmazonで見る

※ Amazon広告リンク

7. 5つのスコープ関数を比較してみよう

ここで紹介したlet・apply・run・also・withの違いを、表にして比べてみましょう。

関数名	使う目的	this / it	戻り値
let	nullチェック、使い捨て	it	lambdaの結果
apply	初期化処理	this	オブジェクト自身
run	処理結果を返す	this	lambdaの結果
also	副作用的な処理（ログなど）	it	オブジェクト自身
with	オブジェクトに処理をまとめる	this	lambdaの結果

このように、使い分けることでKotlinのコードはもっと読みやすく、短く書けるようになります。

【未経験OK】Kotlinで始めるプログラミング入門｜ゼロから「動く喜び」を体験する60分

「プログラミングを始めたい」を形にする。最新言語Kotlinで楽しむ、ものづくりの第一歩。

本講座は、プログラミング経験が全くない方のためのエントリー講座です。「コードを書くってどういうこと？」という基本から、世界中で使われている最新言語Kotlin（コトリン）を使って、実際にプログラムを動かすまでを体験します。難しい理屈よりも、まずは「自分の手で動かす楽しさ」を最短距離で実感していただきます。