本文へスキップ

PR

Kotlin letはいつ使う?迷わない3つの場面と使いすぎを防ぐコツ

Kotlin letはいつ使う?迷わない3つの場面と使いすぎを防ぐコツ
Kotlinのletって本当によく見かけるけれど、結局いつ使えばいいのか全然わからないです…
便利だからといって何でもletで書くと、かえって読みにくいコードになってしまいますよね。

Kotlinを学び始めると、誰もが一度は「とりあえずletを使っておけばKotlinらしいコードになる」という思い込みにハマってしまうのではないでしょうか?

ネット上のサンプルコードを見ると、あちこちにletが散りばめられていますよね。

でも、周りの書き方を真似してやたらとletを多用した結果、「後から自分で読み返しても何をしているのかさっぱりわからない」という経験はありませんか?

letは万能の道具ではありません。使う場面を明確に絞らなければ、ただの読みにくい暗号文になってしまいます。

「短くてスマートなコードを書きたい」という気持ちはとても自然なものです。

しかし、無理にスコープ関数を詰め込むことと、誰にとっても読みやすく安全なコードを書くことはまったくの別物なんですよね。

例えば料理で言うなら、「隠し味の調味料を大量に入れすぎて元の素材の味が台無しになっている状態」と同じです。

隠し味は、ここぞというポイントで適量を加えるからこそ料理全体を引き立ててくれますよね。

この記事ではKotlinのletを使うべき場面と使いすぎを防ぐコツについて解説していきます。

この記事でわかること

  • letを使うべき代表的な3つの場面がわかります
  • letと他のスコープ関数との明確な違いを理解できます
  • コードを複雑にしないための使いすぎを防ぐコツが身につきます

Kotlinのletを使うべき3つの場面

Kotlinのletを使うべき3つの場面

「letはいつ使えばいいのか?」という疑問に対する結論は、特定の3つの場面に限定して使うことです。

あれこれ難しく悩む必要はありません。

実務でletが本当に役立つのは、次の3つの場面だけだと割り切ってしまいましょう。

  1. null安全な処理をスッキリ書きたいとき
  2. 関数の呼び出し結果を一時変数なしで変換したいとき
  3. 変数のスコープを局所的に狭めたいとき

1. null安全な処理をスッキリ書きたいとき

1つ目は、?.letという形でセーフコール演算子と組み合わせて使う場面です。

これがletの最も基本的であり、最も実用的な使い方ですね。

対象の値がnullでないときだけ特定の処理を行いたい場合、余計なif文のネストを作らずに記述できます。

通常のif文でnullチェックするのと何が違うのですか?
スマートキャストが効かないプロパティでも、安全に中身を取り出して操作できるのが大きな利点ですよ。

例えば、入力フォームから渡されたデータがnullでない場合だけ登録処理へ進めたい場面などで、コードの階層を深くせずに安全な処理を組み立てられます。

2. 関数の呼び出し結果を一時変数なしで変換したいとき

2つ目は、計算やデータ取得の結果を受け取って、すぐに別の形式へ変換して次の処理へ渡したい場面です。

たった一度しか使わない中間変数の名前を考えるのは面倒ですし、無駄な変数がコード内に散らばるのはミスの原因になりますよね。

一度きりの使い捨て変数に悩むくらいなら、letを使ってその場で変換して次の処理へ流すのが効率的です。

例えば、データベースから取得した日付の文字列をフォーマット変換して画面に表示するような処理も、流れるような一本の処理としてスマートに書くことができます。

3. 変数のスコープを局所的に狭めたいとき

3つ目は、特定の変数を「このブロックの中だけで使いたい」という場面です。

広い範囲で変数を定義してしまうと、関係のない場所で誤ってその変数を呼び出したり、値を変更してしまったりするリスクが高まりますよね。

あえてletのブロックで処理を囲むことによって、その中だけで有効な変数として扱えるため、コードの安全性を高める防波堤として機能してくれるわけです。

無料:WordPress ブログの初期設定チェックリスト
28 の設定を 1 枚にまとめた PDF と、5 日間のミニ講座をメールでお届けします。

letがnull安全の処理で選ばれる理由

letがnull安全の処理で選ばれる理由

なぜKotlinにおいて?.letがこれほど広く使われているのでしょうか?その本質は、単にコードを短くすることではなく「安全性」にあります。

nullチェックだけなら普通のif文でも十分ではないですか?
変更可能なプロパティだと、if文のチェック後に値が変わる恐れがあるため自動変換が働かないのですよ。

Kotlinでは、変更可能な変数(var)を単純なif文でチェックしても、別のスレッドなどから値が変更される可能性を排除できないため、コンパイラによるスマートキャストが機能しません。

しかし、?.letを使えばブロック内の引数として値が確定されるため、確実にnullでない値として安全に扱えるようになります。

  • 複雑なif文のネストを排除してコードの見た目をすっきり整えられる
  • マルチスレッド環境でも値の変更に影響されず安全に処理できる
  • nullのときは何も処理を行わないという意図を明確に表現できる
スマートキャストが効かない場面でもスムーズに安全性を確保できる点こそが、letの最大の強みです。

では、実際に?.letを呼び出したときにnullと非nullでどのような動作の違いが生まれるのでしょうか?

「nullのときは本当に処理がスキップされて結果もnullになるのか?」という疑問を確かめるために、筆者の環境で試した結果をご紹介します。

このコードは、文字列が入った変数とnullの変数のそれぞれに対して?.letを呼び出し、ブロック内の処理が実行されるかどうかと式全体の戻り値を確認するものです。

fun main() {
    // null かもしれない変数を2つ用意する
    val name1: String? = "Kotlin"
    val name2: String? = null

    // ?.let は null でないときだけブロックを実行する
    name1?.let { println("name1の文字数:${it.length}") }
    name2?.let { println("name2の文字数:${it.length}") }

    // null のときは let 全体が null になる
    val r = name2?.let { it.length }
    println("name2?.letの戻り値:$r")
}

出力結果を見ると、値が存在するname1のときだけブロック内の文字数カウント処理が走り、nullが入っているname2では処理が完全にスキップされているのがわかりますね。

さらに最後の出力からわかるように、呼び出し元がnullの場合、?.let式全体の評価結果も安全にnullとして返されています。

name1の文字数:6
name2?.letの戻り値:null

このように、面倒な条件分岐を書かなくても安全に処理を振り分けられることが、手元での検証結果からもハッキリと確かめられました。

一時変数を減らし可読性を高める理由

一時変数を減らし可読性を高める理由

letが重宝される2つ目の理由は、不要な一時変数を減らしてコードの保守性を高められるからです。

例えば、文字列を加工して別のオブジェクトを生成する処理を想像してみてください。

「temp」「data1」のような中身の意図が伝わりにくい適当な変数名がいくつも並んでいるコードを見て、うんざりしたことはありませんか?

一時変数を1つ置くだけでも、そんなに問題になるのでしょうか?
後から読む人が「この変数は後でまた使われるのかな?」と余計な推測をしなければならなくなりますよ。

無駄な変数が残り続けると、読み手はその変数が後続の処理で再利用されるのではないかと常に警戒しなければならなくなります。

letを活用すれば、変換処理の中で一時的な計算を行い、その結果をダイレクトに次のステップへ引き渡すことが可能です。

  • 意味の薄い一時変数の命名に無駄な時間を使わずに済む
  • 変数の生存期間がブロック内に限定されるため誤用を防げる
  • データの加工から受け渡しまでの流れが一直線に把握しやすくなる
変数の寿命をできる限り短く保つことこそが、バグを防ぎ読みやすいコードを作るための本質です。

ここで初心者がよく迷うのが、letと非常によく似たスコープ関数であるalsoとの違いではないでしょうか?

「letとalsoでは戻り値にどんな違いがあるのか?」という疑問に答えるために、筆者の環境で試した結果を見てみましょう。

このコードは、同じ数値に対してletとalsoをそれぞれ呼び出し、ブロック内で値を2倍にする計算を行ったときに、式全体として返ってくる値を比較するものです。

fun main() {
    val num = 10

    // let はブロックの最後の式を返す
    val a = num.let { it * 2 }
    // also は元のオブジェクトをそのまま返す
    val b = num.also { it * 2 }

    println("letの戻り値:$a")
    println("alsoの戻り値:$b")
}

出力結果を見ると、letの戻り値はブロックの最後の式を評価した結果である20になっているのに対し、alsoの戻り値は計算前の元の値である10のままですね。

ここからわかるのは、値を別の結果に変換して次の処理へ渡したいときはletを使うのが正解であり、元のオブジェクトをそのまま維持したいログ出力などにはalsoを使うべきだという明確な役割の違いです。

letの戻り値:20
alsoの戻り値:10

戻り値の違いがわかったら、nullのときの書き方も押さえましょう。if式とエルビス演算子の使い分けを知ると、条件分岐を迷わず書けます。

Kotlinに三項演算子がない理由とif式・エルビス演算子での代わりの書き方
Kotlinに三項演算子がない理由とif式・エルビス演算子での代わりの書き方 他言語からKotlinに入ってきた方の多くが、一度は同じ壁にぶつかって戸惑ってしまいますよね。 「なんで便利な三項演算子(? :)がないの?不便…

letの使いすぎを防ぐ3つの鉄則

letの使いすぎを防ぐ3つの鉄則

「letが便利だから」といって、あらゆる処理をletで書こうとするのは絶対にやめましょう。

使いすぎるとコードは驚くほど読みづらくなります。

これを防ぐための実践的な手順を、優先順位の高い順にご紹介します。

  1. 最優先:letのネストを避けて早期リターンや関数の分割を行う
  2. 第2順位:単純なnullチェックであれば従来のif文を使う
  3. 第3順位:エルビス演算子と組み合わせる際の戻り値に注意する
letの中でさらにletを呼び出すと、itが何を指しているのかわからなくなりますよね…
それこそが典型的な使いすぎの失敗例です。ラムダの引数に名前をつけるか処理を分けるべきですよ。

例えば、letを幾重にも入れ子にしてしまうと、暗黙の変数であるitが何を表しているのか、書いた本人ですら見失ってしまいます。

また、「Kotlinだからすべてスコープ関数で書かなければいけない」という思い込みも捨ててください。

単純な条件分岐であれば、誰が見ても一瞬で構造が理解できる素直なif文を書くほうが圧倒的に親切なんですよね。

小手先のテクニックで短く見せることよりも、チーム全員が迷わず読める素直なコードを最優先にしてください。

実務で特に注意したいのが、?.letとエルビス演算子(?:)を安易に組み合わせて「if-else文の代わり」として使ってしまうケースです。

「letのブロック内部がnullを返したときにどう動くのか?」という疑問に答えるため、筆者の環境で試した結果をご紹介します。

このコードは、通常のエピルビス演算子との併用に加えて、letブロックの内部が明示的にnullを返したときに後ろの処理がどう動作するかを検証したものです。

fun main() {
    val text: String? = null

    // ?.let と ?: を組み合わせて、null のときの処理を書く
    val msg = text?.let { "値あり:$it" } ?: "値なし"
    println("textがnullのとき:$msg")

    // 注意:let の最後が null を返すと、?: 側も実行される
    val s: String? = "abc"
    val res = s?.let { null } ?: "elseも実行された"
    println("letがnullを返したとき:$res")
}

1つ目の出力では、対象がnullだったため想定通り「値なし」が表示されていますね。

しかし2つ目の出力に注目してください。

元の文字列はnullではないにもかかわらず、letブロックがnullを返したせいで、後ろのエルビス演算子側の処理が実行されて「elseも実行された」と出力されてしまっています。

textがnullのとき:値なし
letがnullを返したとき:elseも実行された

このように、letの内部でnullを返す可能性がある場合、?.letと?:の組み合わせはif-else文の完全な代わりにはならないという落とし穴があります。

予期せぬ不具合を防ぐためにも、複雑な条件分岐は素直にif-else文を使いましょう。

Kotlinのletに関するよくある質問

Kotlinのletに関するよくある質問

スコープ関数を使い始めると、書き方の細かい部分や他の構文との使い分けで悩む場面が増えてきますよね。

慣れないうちは、どのスコープ関数を使うのが正解なのか迷ってしまいます…
最初から全部を使いこなそうと焦らず、まずは基本のletから少しずつ慣れていけば大丈夫ですよ。

読者が次につまずきやすいポイントについて、Q&A形式で疑問にお答えします。

itの名前は自由に変更してもよいですか?

はい、自由に変更できます。letブロック内の処理が長くなったり変数の意味を強調したいときは、明示的な名前を付けたほうが可読性が向上します。

letとrunはどのように使い分ければよいですか?

引数をitで受け取りたいときはlet、thisとして扱いたいときはrunを選びます。対象オブジェクトのプロパティを直接参照したい場面ではrunが適しています。

Javaから移行したばかりですが無理にletを使うべきですか?

いいえ、無理に使う必要はありません。慣れるまでは標準的なif文で安全に処理を書き、コードを整理したくなった段階で少しずつ取り入れるのがおすすめです。

構文を無理に詰め込むことよりも、チームの誰もが読み間違えない安全なコードを書く意識が何より重要です。

疑問を一つずつ解消しながら、着実に実践的なコーディングスキルを身につけていきましょう。

実践的なスキルを磨くおすすめのスクール

実践的なスキルを磨くおすすめのスクール

Kotlinの文法や安全なコード設計を独学で学んでいると、「自分の書いたコードが本当に現場で通用する書き方なのか」を一人で判断するのは難しいですよね。

一人で勉強していると、文法を覚えても実践的な書き方が合っているのか不安になります…
そんなときは、プロのサポートや質問環境を活用して効率的に学習を進めるのが近道ですよ。

コードの品質を高めて現場で活躍できるエンジニアを目指すなら、プロへの質問や手厚いサポートを受けられる環境を活用するのがおすすめです。

SHIFT TERAS CAMPUS

未経験からITエンジニアへの転職を目指すプログラミングスクールです。

転職支援がついており、本格的にエンジニアへのキャリアを目指す方に適しています。

学習はオンライン中心で進めることができ、疑問点は回数無制限で質問可能です。

24時間使えるAI質問アプリも用意されているため、自分の生活リズムに合わせてスムーズに学習を進められます。

  • 向いている人:未経験からエンジニアへの転職を目指し、いつでも質問できる手厚い環境で学びたい人
  • 利用するときの注意点:オンライン中心の学習となるため、自分で学習時間を確保して計画的に進める姿勢が必要です
手厚いサポートを受けながら、転職を見据えて着実にプログラミングを学びたい方に最適です。

公式サイトはこちら
転職保証付きプログラミングスクール DMM WEBCAMP

Skill Hacks

未経験者向けのプログラミング動画講座(Programming Hacks)です。

動画形式で基礎からわかりやすく学べる設計になっています。

LINEを使って回数無制限で質問でき、受講期間の制限もありません。

自分のペースを崩さずにじっくりとスキルを習得したい方に向いています。

  • 向いている人:動画でマイペースに学習を進めたい人や、LINEで手軽に質問したい人
  • 利用するときの注意点:受講期間が無制限だからこそ、自分で学習のペースを保たないと後回しにしてしまう可能性があります

期限に追われることなく、LINEで気軽に疑問を解消しながら学びたい方におすすめです。

公式サイトはこちら
Skill Hacks

CodeCamp

現役のエンジニアから、オンライン・マンツーマンで教わるプログラミングスクールです。

マンツーマンのレッスンの中で、わからないところをその場で質問して直接解決できます。

個別指導で着実に理解を深めながら学習を進められます。

  • 向いている人:現役エンジニアからマンツーマンで直接学び、疑問をその場ですぐに解決したい人
  • 利用するときの注意点:レッスン時間を最大限に活かすために、事前に質問したいポイントを整理して準備しておくことが大切です

マンツーマンのレッスンで、疑問を残さずにその場で解決しながら進めたい方にぴったりです。

公式サイトはこちら
CodeCamp

Kotlinのletを適切に使って綺麗なコードへ

Kotlinのletを適切に使って綺麗なコードへ

今回は、Kotlinのletを使うべき場面と、コードを複雑にしないための使いすぎ防止策について解説しました。

letはとても強力で便利な構文ですが、「いつ使うか」と同じくらい「いつ使わないか」を見極めることが大切です。

コードを短く見せることばかりに気を取られて、可読性を落としてしまっては本末転倒ですよね。

まずは基本となるnull安全の処理や一時変数の削減から丁寧に取り入れ、少しずつKotlinらしい自然で読みやすいコードを書いていきましょう。

自信を持ってシンプルなコードが書けるようになれば、日々の開発はもっと楽しくなりますよ。
迷ったときは「誰が見ても意図がすぐに伝わるかどうか」を基準にして、無理のない素直な実装を心がけてくださいね。

焦らず日々のコーディングを重ねて、読みやすく壊れにくい美しいKotlinコードを目指していきましょう。

公式サイトはこちら
転職保証付きプログラミングスクール DMM WEBCAMP
Skill Hacks
CodeCamp

letの使いどころは、書いたコードを誰かに見てもらうと一気に身につきます。質問できる環境なら、現場で通用する書き方に早く近づけますよ。

プログラミングスクールおすすめ比較|初心者が最短でスキル習得できる選び方とは? プログラミングを学びたいけれど、何から始めればいいのか迷ってしまう人は多いですよね。 ネットで調べれば情報は山ほど出てきますが、その分だけ選択肢…

WordPressテーマ「SIMPLE」

simple

「SIMPLE」は、シンプルなデザインと多彩な機能を兼ね備えたオリジナルWordPressテーマです。

無料:WordPress ブログの初期設定チェックリスト
28 の設定を 1 枚にまとめた PDF と、5 日間のミニ講座をメールでお届けします。

LINEでお知らせ

「SIMPLEの最新情報」

新機能やアップデートのお知らせを、LINEで受け取れます。

友だち追加

この記事を書いた人

マルユメ

元社畜。ブラック企業で5年間鬼労働して1000万貯金→退職。27歳。WordPressテーマを自作。ブログを4つ運営中。

RELATED POSTS

COMMENT FORM

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です