本文へスキップ

PR

Swift extensionの使い方|既存の型に機能を足す4つの書き方

Swift extensionの使い方|既存の型に機能を足す4つの書き方
Swiftでアプリを作っているのですが、既存のクラスや構造体に新しい機能を追加したいとき、どう書けばいいのかわかりません。元のコードを変更せずに機能を追加する方法はありますか?
それならSwiftのextensionを使えば一瞬で解決しますよ。元のコードを直接いじらずに、外側からサクッと機能を付け足すスマートな方法を教えますね。

既存の型にちょっとした便利機能を追加したい場面って、アプリ開発をしていると本当によくありますよね。

例えば、文字列の日付変換メソッドや色の独自定義など、「これ標準で用意しておいてくれたらいいのに」と感じた経験はありませんか?

だからといって、標準の型や他人が書いたコードを無理やり書き換えようとしたり、わざわざ新しい子クラスを作って継承させようとしたりするのは、設計としてもメンテナンスの観点からもかなり筋が悪いんですよね。

元の設計を壊さずに安全に拡張することこそが、読みやすく壊れにくいコードを書くための基本原則です。

「でも、どうやって既存の型に機能を付け足せばいいの?」と迷ってしまうのも無理はありません。

この記事ではSwift extensionの使い方と既存の型に機能を足す4つの書き方について解説していきます。

この記事でわかること

  • Swiftのextensionを使うメリットがわかります
  • 既存の型を拡張する4つの書き方がわかります
  • コードが散らからない設計のコツがわかります

既存の型を拡張する4つの基本パターン

既存の型を拡張する4つの基本パターン

結論から言うと、Swiftで既存の型に機能を追加したいなら、extensionを活用するのが最も安全でスマートな選択肢なんですよ。

難しく考える必要は全くなくて、実務で使う書き方のパターンは基本的に4つだけなんですよね。

ネット上の解説を読むと小難しく書かれがちですが、基本となる書き方は次の4つを押さえておけば十分なんですよ。

  1. メソッドを追加する書き方
  2. 計算プロパティを追加する書き方
  3. イニシャライザを追加する書き方
  4. プロトコルに適合させる書き方
この4つの書き方を状況に合わせて使い分けるだけで、コードの品質は劇的に向上します。

それぞれどのようなコードになるのか、具体的な書き方を1つずつ確認していきましょうか。

メソッドを追加する書き方

最も直感的でよく使われるのが、型に新しいメソッドを追加する書き方ですね。

例えば、Int型に対して「数値を2乗する」という計算処理をメソッドとして足してあげるだけで、計算処理の呼び出しが驚くほどスッキリするんですよ。

extension Int {
    func squared() -> Int {
        return self * self
    }
}

let number = 4
print(number.squared()) // 16

わざわざ独自の関数を作って引数に数値を渡すよりも、数値自身からメソッドを呼べたほうが圧倒的に読みやすいと思いませんか?

計算プロパティを追加する書き方

2つ目は、計算プロパティを追加する書き方です。

ここで注意してほしいのは、値を新しく保持するストアドプロパティは追加できないという点なんですよね。

あくまで既存の値から計算して結果を返すプロパティだけを定義できます。

例えば、Double型に対して「消費税込みの金額を返す」計算プロパティを追加すると、このような書き方になります。

extension Double {
    var taxIncluded: Double {
        return self * 1.10
    }
}

let price: Double = 1000
print(price.taxIncluded) // 1100.0

引数を渡す必要がないシンプルな値の変換なら、メソッドにするよりも計算プロパティにしたほうがコードがシンプルになりますよね。

イニシャライザを追加する書き方

3つ目は、既存の型に新しい初期化処理を追加する書き方です。

特に構造体で大活躍する書き方でして、extensionの中でイニシャライザを追加すると、Swiftが自動生成してくれる全項目イニシャライザを維持できるという大きなメリットがあるんですよ。

例えば、RGBの整数値から独自のColor構造体を初期化したい場合は、次のように記述します。

struct CustomColor {
    var red: Double
    var green: Double
    var blue: Double
}

extension CustomColor {
    init(white: Double) {
        self.red = white
        self.green = white
        self.blue = white
    }
}

let gray = CustomColor(white: 0.5)
let rgb = CustomColor(red: 1.0, green: 0.0, blue: 0.0)

構造体の本体の中にイニシャライザを直接書いてしまうと自動生成の初期化が消えてしまうので、このテクニックはぜひ覚えておいてくださいね。

プロトコルに適合させる書き方

4つ目は、既存の型をプロトコルに適合させる書き方です。

元の型を定義した場所とは別の場所で、「この型にこのプロトコルの振る舞いを足します」と宣言できるのが本当に便利なんですよね。

例えば、自作のユーザー構造体を同値比較可能なプロトコルに適合させるコードを見てみましょう。

struct User {
    let id: Int
    let name: String
}

extension User: Equatable {
    static func == (lhs: User, rhs: User) -> Bool {
        return lhs.id == rhs.id
    }
}

プロトコル適合ごとにextensionを分けてあげると、どこで何の処理を実装しているのかが一目瞭然になりますよね。

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

継承よりも拡張を使うべき最大の理由

継承よりも拡張を使うべき最大の理由

「機能を追加したいなら、クラスを継承して新しい子クラスを作ればいいんじゃないの?」と思う方もいるかもしれませんね。

親クラスを継承して新しいクラスを作れば、同じように機能を追加できるように思えますが、それではダメなんですか?
ダメではありませんが、継承には構造体に使えないという決定的な弱点があるんですよ。

現代のSwift開発において、安易なクラスの継承はトラブルの原因になりやすいんですよね。

extensionを優先して使うべき理由は、以下の通りです。

  • Swiftで主役となる構造体は継承ができない
  • StringやIntなどの標準の型を直接拡張できる
  • 不要なクラスの階層構造を作らずに済む

例えば、Swiftで書くモダンなプログラムでは、クラスよりも値型である構造体を好んで使いますよね。

構造体には継承という仕組みそのものがありませんから、「継承で機能を追加する」という発想自体が通用しないわけです。

継承ばかりに頼った設計をしていると、Swift本来の強みである構造体の安全性を自ら捨てることになってしまいますよ。

さらに、標準の型を継承した独自クラスを作って使い回そうとすると、プロジェクト全体のコードが無駄に複雑化してしまいますよね。

元の型そのものを直接拡張できるextensionこそが、Swiftの言語思想に最も合致したアプローチなんですよ。

コードの肥大化を防いで整理整頓できる

コードの肥大化を防いで整理整頓できる

extensionを使うもう1つの大きな理由は、1つのファイルや型が巨大化するのを防げるからなんですよ。

アプリ開発を始めたばかりの人が必ずと言っていいほど直面するのが、1つのファイルに何百行も処理を詰め込んでしまう失敗例なんですよね。

1つの場所に何でも詰め込んでしまうと、どこに何が書いてあるのか本人すら把握できなくなってしまいますよね。

extensionを上手に使うと、次のようにコードの役割をきれいに切り分けることができます。

  • 画面表示の処理とイベント通知の処理を別々に記述できる
  • プロトコルごとの実装を独立したブロックに隔離できる
  • 機能単位でファイルを分割して見通しを保てる

例えば、1つの画面処理の中に、通信処理もレイアウト処理もボタンを押したときの処理も全部並べて書いたらどうなるでしょうか?

スクロールするだけで疲れてしまうような見づらいファイルが出来上がってしまいますよね。

extensionを使って役割ごとにコードを分割することは、散らかった部屋に専用の収納ボックスを置いて片付けるのと同じなんですよ。

「コードが長くなってきたな」と感じたら、機能ごとにextensionで区切る習慣をつけてみてください。

それだけで、後から見返したときのメンテナンスのしやすさが別次元に変わりますよ。

extensionで整理するなら、拡張する型そのものも上手に設計したいですよね。enumの使い方を押さえると、状態や種類をすっきり表せるようになりますよ。

Swift enumの使い方|rawValue・関連値・switchを例で理解
Swift enumの使い方|rawValue・関連値・switchを例で理解 プログラミングを学んでいると、enum(列挙型)を「月火水木金土日」や「東西南北」のような、決まった文字を並べるだけの機能だと思っていませんか?…

失敗を防ぐextensionの実装手順

失敗を防ぐextensionの実装手順

extensionの便利さは理解できたと思いますが、何も考えずに使い始めると、それはそれでコードが散らかる原因になってしまうんですよね。

何でもかんでもextensionに放り込んでいたら、かえってコードがごちゃごちゃになってしまいました。どう整理すればいいですか?
そうなるのを防ぐために、実装する順番とルールをあらかじめ決めておくことが大切なんですよ。

失敗を防ぐためには、優先順位を意識しながら次の手順で実装を進めることをおすすめします。

  1. 優先度高:型定義と同じファイル内でプロトコルごとにextensionを分ける
  2. 優先度中:アプリ全体で使い回す汎用的な拡張は専用ファイルを作成する
  3. 優先度低:特定の画面でしか使わない特殊な拡張は限定公開にする

例えば、プロジェクト全体で使う「文字列から日付への変換」のような拡張は、ファイル名を工夫して別ファイルに切り出すのが鉄則ですね。

import Foundation

extension String {
    func toDate(format: String = "yyyy-MM-dd") -> Date? {
        let formatter = DateFormatter()
        formatter.dateFormat = format
        formatter.locale = Locale(identifier: "ja_JP")
        return formatter.date(from: self)
    }
}

このように別ファイルへ切り出しておくことで、チーム開発でも「どこに共通機能があるか」が一発で分かるようになります。

ここで、継承とextensionの使い分けに迷ったときのために、両者の違いを比較表で整理しておきましょう。

extension クラスの継承
構造体への適用 可能です 不可能です
元コードの修正 不要です 不要です
プロパティの保持 計算プロパティのみです ストアドプロパティも可能です
新しくデータを保持したいなら別の型を作り、既存の型に便利な操作を足したいだけならextensionを使うと覚えておけば間違いありません。

この基準さえブレなければ、設計で道に迷うことはほぼなくなりますよ。

Swiftの拡張でよくある疑問と回答

Swiftの拡張でよくある疑問と回答

extensionの中でストアドプロパティを追加できますか?

追加できません。extensionで追加できるのは計算プロパティのみです。メモリ領域を新しく確保する変数は宣言できない仕様になっています。

既存のメソッドを上書きすることはできますか?

基本的にはできません。extensionは機能を拡張するための仕組みであり既存の処理を書き換えるものではありません。動作を変えたい場合は別の設計を検討してください。

複数のファイルに分けてextensionを書いてもよいですか?

全く問題ありません。むしろ機能やプロトコルごとに別ファイルへ分割して書くのがSwiftの推奨されるスタイルです。コードの見通しが格段によくなります。

プロパティを追加できないと聞いたときは不便だと思いましたが、計算プロパティで十分代用できるんですね。
そうなんですよ。もしメモリを確保して値を保持したいなら、それは拡張ではなく新しいデータ型を作るべきだというサインなんですよね。

extensionを使っていると、「これって実装できないのかな?」と疑問に思う瞬間が必ず出てきます。

特にストアドプロパティが使えない制約に直面したときは、無理に小細工をしようとせず、素直に新しい構造体を作るか別の設計を考えてください。

言語の仕様に逆らって無理なコードを書くことほど、後々のバグを生む原因はありませんからね。

できない理由を正しく理解しておくことこそが、無駄のない美しいSwiftコードを書くための秘訣です。

ルールをしっかり守っていれば、予期せぬ不具合に悩まされる心配もありませんよ。

挫折せずにSwiftを学べるスクール

挫折せずにSwiftを学べるスクール

Swiftの文法や設計って、独学でネットの記事を拾い読みしているだけだと、「動くけれどこれで合っているのか不安」という状態に陥りやすいんですよね。

コードは動くようになったのですが、自分の設計が綺麗なのか、実務で通用するレベルなのかがわからなくて不安です。
独学の限界を感じたら、プロに直接コードをレビューしてもらえる環境を活用するのが一番の近道ですよ。

自己流のコードで変な癖がついてしまう前に、実績のあるプログラミングスクールで体系的に学ぶのは非常に賢い自己投資なんですよね。

ここでは、あなたの学習目的に合わせて選べる3つのスクールを紹介します。

  • SHIFT TERAS CAMPUS:未経験からIT業界への就職や転職を本気で目指したい人に向いています。カリキュラムが充実している一方で、学習時間をしっかり確保する覚悟が必要になります。
  • Skill Hacks:動画講義で自分のペースで学びたい人や、手厚い質問サポートを受けたい人に向いています。挫折しにくい環境ですが、自主的に動画を見進める自己管理が求められます。
  • CodeCamp:現役エンジニアによるマンツーマンレッスンを受けたい人に向いています。個別のコード添削をじっくり受けられますが、レッスンの予約を計画的に取る必要があります。
独学で何週間もエラーと格闘して時間を消費するくらいなら、質問できる環境でサクッと解決したほうが圧倒的に効率的ですよね。

受講プランやサポートの詳細については時期によって改定される場合がありますので、最新の情報は公式サイトで確認してくださいね。

転職保証付きプログラミングスクール DMM WEBCAMP
Skill Hacks
CodeCamp

extensionを使いこなして脱初心者

extensionを使いこなして脱初心者

今回は、Swiftのextensionを使って既存の型に安全かつスマートに機能を追加する4つの書き方についてお話ししてきました。

元のソースコードを一切汚さずに、外側から必要な機能だけをサッと付け足せるextensionは、Swiftを書くすべてのエンジニアにとって必須の技術なんですよね。

メソッドやプロパティの追加だけでなく、ファイルの肥大化を防ぐ整理整頓の道具としても、今日から積極的に使ってみてくださいね。

最初は「どこまでextensionで書けばいいんだろう?」と迷うかもしれませんが、まずはよく使う小さな便利メソッドを1つ追加してみるところからで十分なんですよ。

実際に手を動かしてコードがスッキリする気持ちよさを一度味わえば、もう以前の書き方には戻れなくなりますよ。

怖がらずにどんどんコードを書いて、ワンランク上の洗練されたSwiftエンジニアを目指していきましょうね。

転職保証付きプログラミングスクール DMM WEBCAMP
Skill Hacks
CodeCamp

自分の設計が実務で通用するか不安なら、コードを見てもらえる環境が近道です。目的に合うスクールの選び方を確かめてみましょう。

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

WordPressテーマ「SIMPLE」

simple

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

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

LINEでお知らせ

「SIMPLEの最新情報」

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

友だち追加

この記事を書いた人

マルユメ

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

RELATED POSTS

COMMENT FORM

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