Kotlinのwithの使い方！レシーバーを切り替える使い方のポイント

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

生徒

「Kotlinのコードで、同じ変数に何度もアクセスしてると見づらくなることってありませんか？」

先生

「ありますね。そんなときに便利なのがwithという関数です。オブジェクトに対する処理をまとめて書けるんですよ。」

生徒

「それは便利そうですね！具体的にどんなふうに使うんですか？」

先生

「それでは、初心者にもわかるようにwithの使い方を説明していきましょう！」

1. Kotlinのwithとは？基本の考え方

Kotlin（ことりん）のwith関数は、特定のオブジェクトに対する処理をひとまとめに書くための強力なツールです。特に、同じ変数のプロパティや関数を何度も繰り返し使う場合、毎回その変数名を記述するのは冗長で、コードが長くなりがちです。

例えば、次のような場合を考えてみましょう。もし、ある変数のプロパティや関数を繰り返し使う必要がある場合、通常は毎回その変数名を付けて記述する必要がありますが、withを使うと、変数名を一度だけ指定するだけで、その後の処理ではthisを省略して使えるようになります。

具体的には、withを使うと、オブジェクトのプロパティや関数をそのオブジェクトに対して直接呼び出しているように見せかけることができ、コードがすっきりと簡潔になります。

たとえば、次のようなコード例を見てみましょう。もし、personというオブジェクトのプロパティを何度も使う場合、毎回person.名前やperson.年齢のように書くのは面倒です。しかし、withを使うと、オブジェクトを最初に指定するだけで、その中のプロパティやメソッドを簡潔に扱うことができます。

2. withの基本的な書き方と構文

withは、Kotlinでコードをより簡潔に書くための便利な構文です。特に、対象となるオブジェクトに対して複数回操作を行う場合に有用で、thisを省略して、コードをスッキリと書くことができます。

基本的な構文は次の通りです。


with(対象の変数) {
    // この中でthisが省略できる
    プロパティや関数を呼び出す
}

以下に、withを使ったシンプルな例を示します。初心者でも理解しやすいように、簡単な文字列操作を行っています。


fun main() {
    val str = "Kotlin入門"
    val result = with(str) {
        // 文字列の長さを取得
        println("文字数：${length}")
        // 文字列を大文字に変換
        println("大文字：${uppercase()}")
        // 戻り値として文字列の長さを返す
        length
    }
    // withブロックから返された戻り値を表示
    println("戻り値：$result")
}

このコードでは、strという変数をwithブロック内で処理しています。length（文字数）やuppercase()（大文字化）を呼び出す際、thisを省略して簡潔に記述できます。また、withブロックの戻り値として、処理の結果である文字列の長さを返しています。

withを使うことで、対象の変数に対して複数の操作を行う際、繰り返し変数名を書く手間を省くことができます。これによりコードの可読性が向上し、メンテナンスもしやすくなります。

3. withとレシーバーとは？初心者向けに解説

レシーバーとは、「処理の対象となるオブジェクト」のことを指します。例えば、with(str)と書くと、strがその後の処理で操作される対象になります。簡単に言うと、レシーバーは、後続のコードで何を操作するかを決めるものです。

このレシーバーを使うことで、例えばstrのメソッドを繰り返し書く必要がなくなり、コードを簡潔に保つことができます。通常、str.someMethod()と書くところが、with(str)を使えば、someMethod()だけで済むようになるんです。

プログラミング未経験者の方でも、例えば次のコード例を見ると、レシーバーがどんなふうに使われるのかがわかりやすくなります。


with open('sample.txt', 'r') as file:
    content = file.read()
    print(content)

上記の例では、open('sample.txt', 'r')がレシーバーとなり、ファイルを読み取る処理に使われます。これにより、コードの中で何度もファイルのオブジェクトを指定しなくてもよくなるため、非常に効率的です。

このように、レシーバーを使うと、同じオブジェクトを繰り返し扱う場合にコードがシンプルになり、可読性も向上します。初心者でも、どこで何を操作しているのかがわかりやすくなり、プログラムを読みやすくする効果があります。

4. withの戻り値に注目しよう

with関数は、Kotlinにおいて非常に便利な構文で、処理を簡潔に記述するために使われます。この関数の特徴は、その中で最後に記述された式が戻り値として返されることです。

例えば、以下のコードでは、with内で文字列「Kotlin」を使って、文字列の長さを計算しています。この計算結果が戻り値となり、resultに格納されます。


val result = with("Kotlin") {
    // withの中での処理
    println("処理中：$this")  // thisは「Kotlin」を指します
    this.length  // 最後の値（文字列の長さ）が戻り値となる
}
println("長さ：$result")  // 結果として6が出力される

このコードでポイントとなるのは、withブロック内で行った処理の結果が、そのまま戻り値として返される点です。最終的に返されるのは、このブロック内で最後に評価されたthis.lengthの部分で、ここでの「this」は「Kotlin」という文字列を指しています。

このように、withを使うことで、コードを簡潔に保ちながら、変数に対する複数の操作や、戻り値の計算を一度に行うことができます。特に複雑なオブジェクトや設定の値を処理する際に便利です。

初心者の方でも、こうしたコードの使い方を覚えると、Kotlinでのプログラミングがよりスムーズに進むようになります。withの戻り値を利用したシンプルな処理は、ぜひ活用してみましょう。

5. オブジェクトの初期化や整形にも使えるwith

withを使うことで、オブジェクトの初期化や文字列の整形をシンプルかつ効率的に行うことができます。特に、複数のメソッドを呼び出す必要がある場合にコードが簡潔になります。

例えば、次のようなコードを見てみましょう。StringBuilderを使って、文字列を組み立てる処理をwithで簡潔に書いています。


val message = with(StringBuilder()) {
    append("こんにちは、")
    append("世界！")
    toString()  // 最後に作成した文字列を返します
}
println(message)

このコードでは、StringBuilderのインスタンスをwithブロック内で作成し、その後、appendメソッドを使って文字列を追加しています。withを使うことにより、レシーバーオブジェクトであるStringBuilderを毎回書く必要がなく、コードが簡潔になります。

また、withを使うことで、複数のプロパティやメソッドをチェーンのように扱うことができるため、冗長なコードを減らし、可読性も向上します。初期化と整形が一貫して行えるため、特にオブジェクトの設定を行う場面では非常に便利です。

例えば、GUIアプリケーションや設定ファイルの読み込み時にもこのような手法が役立ちます。コードの可読性を高め、作業を効率化できるwithは、非常に有用な機能と言えるでしょう。

6. withと他のスコープ関数との違い

Kotlinにはapplyやrunなど他にもスコープ関数がありますが、withの違いは次のとおりです。

withは関数として使い、レシーバーを指定して処理をまとめる
applyはオブジェクトの設定向き（主に初期化）
runはオブジェクトから戻り値を得たいときに使う

初心者のうちは、withは「この中で対象をまとめて処理するもの」と覚えておきましょう。

7. withを使うときの注意点

withはとても便利ですが、以下のような注意点もあります。

処理が長くなりすぎると、どの変数が主役かわからなくなる
ネスト（入れ子）にしすぎると、かえって読みにくくなる
読み手にとってわかりやすい長さに留める

シンプルに書ける範囲で活用するのがポイントです。

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

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

※ Amazon広告リンク

8. Kotlin初心者がwithを練習する方法

初心者がwithの感覚を身につけるには、まず以下のような練習がおすすめです。

文字列やリストをwithで操作する
StringBuilderで文を作る練習をする
オブジェクトの複数の値を処理するケースで使ってみる

まずは身近な処理からwithを使い、使い方に慣れていきましょう。

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

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

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