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

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

生徒

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

先生

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

生徒

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

先生

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

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

スコープ関数とは、ある変数に対して一時的に処理をまとめたいときに使う関数のことです。たとえば「このデータに対して何か処理したい」「このオブジェクトを初期化したい」というときに使われます。

スコープ関数は以下の5種類があります。

どれも似ているようで、少しずつ使い道が違います。

let関数は、変数に対して一時的な処理をしたいときに使います。itという名前で中身を使います。


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


名前の長さは 3 文字です

主に、nullじゃないときだけ処理したいというときに使われます。

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


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


こんにちは Kotlin

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

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


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


中身は：Kotlin
文字数は：6

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

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


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


文字列：Kotlin を使います
KOTLIN

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

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


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


Hello, World!

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

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

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