SwiftのStringInterpolationでログやメッセージをわかりやすく書く方法

1. StringInterpolationとは？

1. StringInterpolationとは？

StringInterpolation（文字列補間）とは、変数や数値を文字列の中に直接埋め込む仕組みです。難しい言葉に聞こえるかもしれませんが、イメージとしては「文章の中に穴を作って、そこにデータを差し込む」感じです。

例えば次のように書きます。

let name = "Taro"
let age = 20
print("私の名前は\(name)で、年齢は\(age)歳です。")

私の名前はTaroで、年齢は20歳です。

このように\(変数名)と書くだけで、その場所に変数の値が差し込まれます。初心者でも理解しやすく、コードも読みやすくなります。

2. なぜStringInterpolationを使うのか？

2. なぜStringInterpolationを使うのか？

もしStringInterpolationを使わない場合、文字列と変数をつなげるために「プラス記号（+）」を何度も書く必要があります。

let product = "Apple"
let price = 150
print("商品名: " + product + " 価格: " + String(price) + "円")

これは少し見づらく、長くなってしまいます。それに比べてStringInterpolationを使うと、すっきりしたコードで読みやすいログやメッセージを書けます。

3. さまざまな型を埋め込む

3. さまざまな型を埋め込む

数値や文字列だけでなく、計算結果や関数の戻り値も直接埋め込めます。

let x = 10
let y = 5
print("合計は\(x + y)です")

合計は15です

このように、わざわざ変数に代入しなくても、式をそのまま埋め込めるのが便利です。

4. ログメッセージでの活用

4. ログメッセージでの活用

アプリを作っていると、途中の処理を確認するために「ログ」を出力することがよくあります。例えばネットワーク通信や計算結果を調べたいときです。

let statusCode = 200
let url = "https://example.com/api"
print("リクエスト先: \(url) ステータスコード: \(statusCode)")

リクエスト先: https://example.com/api ステータスコード: 200

これならログを見たときに、どの処理でどんな値が返ってきたのかが一目でわかります。特にエラーの原因調査などで役立ちます。

5. フォーマットを指定して整える

5. フォーマットを指定して整える

数値をきれいに表示したいときは、String(format:)と組み合わせる方法もあります。例えば小数点以下の桁数を指定できます。

let pi = 3.14159265
print("円周率は\(String(format: "%.2f", pi))です")

円周率は3.14です

このようにすれば、小数点を好きな桁数に丸めて表示できます。数値をログに出すときに便利です。

6. 複数行のメッセージでも活躍

6. 複数行のメッセージでも活躍

Swiftの文字列は複数行にわたって書くこともできます。これとStringInterpolationを組み合わせると、ログを見やすく整形できます。

let name = "Hanako"
let age = 22
let score = 95

let message = """
ユーザー情報:
名前: \(name)
年齢: \(age)
スコア: \(score)
"""
print(message)

ユーザー情報:
名前: Hanako
年齢: 22
スコア: 95

ログを整えて出力すると、後から確認するときにとても便利です。

7. StringInterpolationを使うと読みやすさが向上する

7. StringInterpolationを使うと読みやすさが向上する

初心者のうちは「文字列の中に変数を入れるだけ？」と思うかもしれません。しかし、プログラムが大きくなるほどログやメッセージが増え、読みやすさが重要になります。StringInterpolationを使えば、簡単なコードでわかりやすいログを出力でき、デバッグや開発がスムーズになります。

特にアプリ開発では、ユーザーに見せるメッセージやエラーログをわかりやすく整えることで、トラブル対応もしやすくなります。Swiftの基本機能の中でも実用的で覚えておくべきポイントです。