ページビューの合計

2026年9月10日木曜日

iOSアプリの開発(100 Days of SwiftUI) Day10 – Structs, computed properties, and property observers

100 Days of SwiftUIのDay10です。

Day10の内容は以下の通りです。

1. How to create your own structs

構造体ですね。
構造体と聞くと、複数のデータをまとめたものを想像します。
しかしSwiftはデータだけでなくメソッドも格納できます。
データと振る舞いが定義できるなら、もうそれはオブジェクトですね。
名前はアッパーキャメルケース(単語の最初を大文字にする)です。
StringやIntなどのデータ型と同じですね。

struct Album {
    let title: String
    let artist: String
    let year: Int

    func printSummary() {
        print("\(title) (\(year)) by \(artist)")
    }
}

上記はプロパティを参照するだけだったので、プロパティを変更する構造体について追記します。
もし、この構造体Employeeをインスタンス化してlet変数に代入するとEmployee全体が定数になります。
その場合、プロパティの変更ができなくなります

例えば以下のような処理はコンパイルエラーになります。
emp1.vacationRemaining = 20 プロパティを直接変更: NG
emp1.takeVacation(days: 10) メソッドを呼んでプロパティを間接的に変更: NG

struct Employee {

    let name: String

    var vacationRemaining: Int


    func takeVacation(days: Int) {

        if vacationRemaining > days {

            vacationRemaining -= days

            print("I'm going on vacation!")

            print("Days remaining: \(vacationRemaining)")

        } else {

            print("Oops! There aren't enough days remaining.")

        }

    }

}


let emp1 = Employee(name: "Tom", vacationRemaining: 14)

emp1.vacationRemaining = 20

emp1.takeVacation(days: 10)

では、varに変えればいいですね。
ただそれでは片手落ちです。
emp1.vacationRemaining = 20 プロパティを直接変更: OK
emp1.takeVacation(days: 10) メソッドを呼んで変更: NG

funcの前にmutatingを付けろってのが消えません。
これはこのメソッドがプロパティを変えますよという印です。

構造体のプロパティをメソッド呼び出しで変更するには以下の3つの条件が必要です。

  1. 構造体のインスタンスをvar変数に代入すること。
  2. プロパティの型がvarであること。
  3. 該当のプロパティを変更するメソッドの前に"mutating"を付けること。

あとはこれが構造体のまとめです。

  • 構造体に属する変数と定数はプロパティと呼ばれます。
  • 構造体に属する関数はメソッドと呼ばれます。
  • 構造体から定数または変数を作成する場合、それをインスタンスと呼びます。
  • 構造体のインスタンスを作成する際には、以下のようにイニシャライザを使用します。
    Album(title: "Wings", artist: "BTS", year: 2016)

以下はいわゆるシンタックスシュガーと呼ばれるもので、Swift は構造体の中に init() という特別な関数(イニシャライザ)を暗黙的に作成し、構造体のすべてのプロパティをそのパラメータとして使用します。そして、次の 2 つのコードを自動的に同じものとして扱います。
var archer1 = Employee(name: "Sterling Archer", vacationRemaining: 14)
var archer2 = Employee.init(name: "Sterling Archer", vacationRemaining: 14)
現状ではこの2つは全く同じです。
ですが、何かカスタマイズを行いたい、単にパラメータを渡すだけでなく、チェックロジックを入れたいなどの場合は、init()を独自で定義します。
ただし、自分で定義するとデフォルトのイニシャライザは動作しなくなります。
デフォルトの動作を残しつつ、新たなパターンを行いたい場合は、extensionを使います。


またStructのプロパティはデフォルト値を設定できます。
以下の例では、プロパティ:vacationRemainingにデフォルト値の14を設定しています。
let name: String
var vacationRemaining = 14

デフォルト値があるプロパティはインスタンス化のときに指定が不要になります。
そしてデフォルト以外の値を設定したい場合は、インスタンス化のときに指定します。
let kane = Employee(name: "Lana Kane")
let poovey = Employee(name: "Pam Poovey", vacationRemaining: 35)
注意事項
もしプロパティがlet型でデフォルト値が設定されていると、インスタンス化の時点でパラメータ指定ができなくなります、もし指定するとコンパイルエラーになります。

そしてプロパティがlet型でデフォルト値が設定されていなければ、インスタンス化時のみ値が設定できて、その後は変更が不可能になります。

2. How to compute property values dynamically

構造体には2種類のプロパティがあります。
  1. 格納プロパティは、構造体のインスタンス内にデータを保持する変数または定数です。
  2. 計算プロパティは、アクセスされるたびにプロパティの値を動的に計算します。つまり、計算プロパティは格納プロパティと関数の両方の特徴を併せ持っています。アクセス方法は格納プロパティと同じですが、動作は関数に似ています。

以下のように、計算プロパティvacationRemainingは計算した値を返しています。
1行なのでReturn文は省略しています。
struct Employee {
    let name: String
    var vacationAllocated = 14
    var vacationTaken = 0

    var vacationRemaining: Int {
        vacationAllocated - vacationTaken
    }
}

呼び出し方はこんな感じです。
計算プロパティと言っても中身はメソッドだから、vacationRemaining()って呼ぶんじゃないかと思いましたが、vacationRemainingだけでいいそうです。
var archer = Employee(name: "Sterling Archer", vacationAllocated: 14)
archer.vacationTaken += 4
print(archer.vacationRemaining)
archer.vacationTaken += 4
print(archer.vacationRemaining)

プロパティなら値の設定もできるんじゃ?
できるけどSetterを使うそうです、データ取得のGetterも併せて以下の感じ。
この例だとSetterで逆算する感じですね。
var vacationRemaining: Int {
    get {
        vacationAllocated - vacationTaken
    }

    set {
        vacationAllocated = vacationTaken + newValue
    }
}
呼び出し方は以下の感じ。
例えば5という値を代入すると、それが上記のように、newValueという名前でSetterに渡って逆算に使われます。
var archer = Employee(name: "Sterling Archer", vacationAllocated: 14)
archer.vacationTaken += 4
archer.vacationRemaining = 5
print(archer.vacationAllocated)

3. How to take action when a property changes

Swiftでは、プロパティオブザーバーを作成できます。
プロパティオブザーバーとは、プロパティが変更されたときに実行される特別なコードです。オブザーバーには2つの形式があります。
プロパティが変更された直後に実行されるdidSetオブザーバーと、プロパティが変更される前に実行されるwillSetオブザーバーです。
なんかDBのトリガー(BEFORE UPDATE / AFTER UPDATE)に似ていますね。


プロパティの後ろに{}でコードをそのままアタッチします。
willSetの中で、新しい値をnewValueで参照できます。
didSetの中で、古い値をoldValueで参照できます。

配列も使えますが、その場合はnewValueは更新後の全ての配列の中身、oldValueは変更前の全ての配列の中身になります。

struct App {
    var contacts = [String]() {
        willSet {
            print("Current value is: \(contacts)")
            print("New value will be: \(newValue)")
        }

        didSet {
            print("There are now \(contacts.count) contacts.")
            print("Old value was \(oldValue)")
        }
    }
}

var app = App()
app.contacts.append("Adrian E")
app.contacts.append("Allen W")
app.contacts.append("Ish S")

プロパティオブザーバーを使う際の注意点です。

もし didSet や willSet の中に、以下のような重い処理を書いてしまうと事故が起きます。
重い処理の例:
  • 巨大なファイルを読み書きする
  • ネットワーク通信(APIリクエスト)を飛ばす
  • 重いループ処理や複雑な計算を回す
  • データベースの再構築
何が問題になるのか?
予期せぬパフォーマンス低下(アプリのフリーズ)を招きます。
コードを書いた本人(またはチームメンバー)は「ただ値を代入しただけ」のつもりで呼んでいるのに、裏で重い処理が走って画面がカクついたりフリーズしたりします。

連鎖事故(ループ)が起きやすい
ループ処理の中で contacts.append(...) を100回実行したら、その重い処理も100回連続で実行されてアプリが落ちます。

まとめ
プロパティオブザーバーに書くべきこと:
print でのログ出力、簡単な画面描画更新(ラベルの表示切替など)、フラグのON/OFFといった「一瞬で終わる軽い処理」にします。

重い処理はどうする?:
プロパティの中に隠さず、明示的なメソッド(例: saveData() や syncWithServer()) として独立させて、必要なタイミングで明示的に呼び出します。

4. How to create custom initializers

イニシャライザは、新しい構造体インスタンスを準備するために設計された特殊なメソッドです。
イニシャライザが終了するまでにすべてのプロパティに値が設定されている必要があるという重要なルールに従えば、独自の初期化子を作成することもできます。

まずは、Swiftの構造体のデフォルトイニシャライザをもう一度見てみましょう。
struct Player {
    let name: String
    let number: Int
}

let player = Player(name: "Megan R", number: 15)
Playerは、2つのプロパティに値を指定することで新しいインスタンスを作成します。
Swiftではこれをメンバーワイズイニシャライザと呼びますが、これは各プロパティを定義された順序で受け入れるイニシャライザの言い換えです。

このようなコードが可能なのは、Swiftがこれらの2つの値を受け入れるイニシャライザを自動的に生成してくれるからですが、同じことを行うイニシャライザを独自に記述することもできます。ただし、注意すべき点は、入力されるパラメータ名と代入されるプロパティ名を区別する必要があることです。

それは次のような感じになります。
struct Player {
    let name: String
    let number: Int

    init(name: String, number: Int) {
        self.name = name
        self.number = number
    }
}

イニシャライザにはいくつか注意ポイントがあります。
  1. funcキーワードはありません。確かに、構文的には関数のように見えますが、Swiftではイニシャライザは特別な扱いを受けます。
  2. これは新しいPlayerインスタンスを作成しますが、イニシャライザは明示的に戻り値の型を持つことはありません。常にそれが属するデータの型を返します。
  3. selfをプロパティにパラメータを割り当てるために使っています。これはnameパラメータをnameプロパティに割り当てることを意味します。

最後の点は特に重要です。なぜなら、self がなければ name = name となり、意味が通じないからです。
プロパティをパラメーターに代入しているのか、パラメーター自体に代入しているのか、それとも別の何かなのかが分かりません。
self.name と記述することで、「現在のインスタンスに属する name プロパティ」を意味していることを明確にし、それ以外の何かではないことを示せるのです。

もちろん、カスタムイニシャライザは、Swiftが提供するデフォルトのメンバーごとのイニシャライザと同じように動作する必要はありません。
たとえば、プレイヤー名は必須だが、背番号はランダム化する、といった設定も可能です。

struct Player {
    let name: String
    let number: Int

    init(name: String) {
        self.name = name
        number = Int.random(in: 1...99)
    }
}

let player = Player(name: "Megan R")
print(player.number)

重要なルールを覚えておいてください。初期化処理が終了するまでに、すべてのプロパティに値が設定されている必要があります。
初期化処理内でnumberに値を指定していなかった場合、Swiftはコードのビルドを拒否します。

重要
イニシャライザ内で構造体の他のメソッドを呼び出すことはできますが、すべてのプロパティに値を割り当てる前に呼び出すことはできません。
Swift は、他の処理を行う前にすべてが安全であることを確認する必要があるためです。

構造体には、必要に応じて複数のイニシャライザを追加したり、外部パラメータ名やデフォルト値などの機能を利用したりできます。
ただし、独自のカスタムイニシャライザを実装すると、特別な手順を踏まない限り(*)、Swift が生成するメンバごとのイニシャライザにアクセスできなくなります。
これは意図的な動作です、カスタムイニシャライザがある場合、Swift はプロパティを初期化する特別な方法があるとみなし、デフォルトのイニシャライザは利用できなくなると判断します。

*
ここでは触れていないようですが、デフォルトのイニシャライザを残しつつ、独自のカスタムイニシャライザを実装するには、extensionを使います。







0 件のコメント:

コメントを投稿

iOSアプリの開発(100 Days of SwiftUI) Day 26 – Project 4, part one

100 Days of SwiftUIの Day26 です。 今日から新しいプロジェクトを始めます。SwiftUIのスキルをさらに磨きながら、プログラミングの魅力的な分野である機械学習にも挑戦していきます。 オックスフォード大学で教鞭を執るスウェーデン人教授、ニック・ボストロムは...