RealmKeyedCollection

このコレクションに関連付けられているキーの型

このコレクションに関連付けられている値の型。

マップを管理する Realm、またはマップが管理されていない場合はnil 。

マップがアクセスできなくなっているかどうかを示します。

このマップ内のキーと値のペアの数を返します。

マップに含まれるオブジェクトの人間が判読可能な説明。

指定されたキーの辞書に保存されている値をアップデートし、キーが存在しない場合は新しいキーと値のペアを追加します。

指定されたキーとそれに関連付けられたオブジェクトを削除します（キーが辞書に存在する場合のみ）。 キーが存在しない場合、辞書は変更されません。

辞書からすべてのオブジェクトを削除します。 オブジェクトは、それらを管理する Realm から削除されません。

指定されたキーの値を返します。または、サブスクリプトを割り当てに使用する場合は、キーの値を設定します。

マップ内に存在する場合は、指定されたキーのValueのタイプを返します。

キー値のコーディングを使用する場合、キーは string である必要があることに注意してください。

マップ内に存在する場合は、指定されたキーのValueのタイプを返します。

指定されたキーと値のペアを辞書に追加するか、指定されたキーがすでに存在する場合は更新します。

指定された述語と一致するすべての値を含むResultsを返します。

マップにキーと値のペアが指定された述語を満たすかどうかを示すブール値を返します。

辞書内のオブジェクトをソートされた状態で含むResultsを返します。

オブジェクトは、 値に基づいてソートされます。 たとえば、 Dateの辞書を新しいセットから最も古い順に並べ替えるには、 dates.sorted(ascending: true)を呼び出します。

辞書内のオブジェクトをソートされた状態で含むResultsを返します。

オブジェクトは、指定されたキー パスの値に基づいてソートされます。 たとえば、 ageプロパティに基づいて、 Studentの辞書を最も小さいものから最も古い順に並べ替えるには、 students.sorted(byKeyPath: "age", ascending: true)を呼び出します。

辞書内のオブジェクトをソートされた状態で含むResultsを返します。

この辞書内のすべてのキーを返します。

辞書内のすべての値を返します。

コレクション内のすべてのオブジェクト間で指定されたプロパティの最小（最小）値を返します。辞書が空の場合はnilを返します。

辞書内のすべてのオブジェクト間で指定されたプロパティの最大値（最高値）を返します。辞書が空の場合はnilを返します。

辞書内のオブジェクトの指定された プロパティの合計を返します。辞書が空の場合はnilです。

辞書内のすべてのオブジェクトにわたる指定されたプロパティの平均値を返します。辞書が空の場合はnilです。

辞書が変更されるたびに呼び出されるブロックを登録します。

ブロックは最初の辞書とは非同期に呼び出され、辞書内のキーまたは値のいずれかを変更する書き込みトランザクションごとに再度呼び出されます。

ブロックに渡されるchangeパラメータは、各書込みトランザクション中に追加、削除、または変更されたキーと値のペアを、辞書内のキーの形式で報告します。

ブロックが呼び出される時点で、辞書は完全に評価され、最新の状態になります。同じスレッドで書込みトランザクションを実行したり、 realm.refresh()を明示的に呼び出したりしない限り、アクセスはブロッキング実行されない限り、動作する。

キューが指定されていない場合、通知は標準の実行ループを介して配信されるため、実行ループが他のアクティビティによってブロックされている間は通知を配信できません。 キューが指定されている場合、代わりにそのキューに通知が配信されます。 通知をすぐに配信できない場合は、複数の通知が 1 つの通知に統合されることがあります。 これには、初期コレクションの通知を含めることができます。

たとえば、次のコードは通知ブロックを追加した後すぐに書込みトランザクションを実行するため、最初の通知が最初に配信される可能性はありません。 その結果、最初の通知には、書込みトランザクション後の Realm の状態が反映されます。

let myStringMap = myObject.stringMap
print("myStringMap.count: \(myStringMap?.count)") // => 0
let token = myStringMap.observe { changes in
    switch changes {
    case .initial(let myStringMap):
        // Will print "myStringMap.count: 1"
        print("myStringMap.count: \(myStringMap.count)")
       print("Dog Name: \(myStringMap["nameOfDog"])") // => "Rex"
        break
    case .update:
        // Will not be hit in this example
        break
    case .error:
        break
    }
}
try! realm.write {
    myStringMap["nameOfDog"] = "Rex"
}
// end of run loop execution context

キー パスが指定されていない場合、ブロックは、すべてのオブジェクト プロパティとネストされたリンクされたオブジェクトのプロパティの挿入、変更、または削除時に実行されます。 キー パスが指定されている場合、指定されたキー パスでのみ発生する変更に対してブロックが呼び出されます。 たとえば、次の場合:

class Dog: Object {
    @Persisted var name: String
    @Persisted var age: Int
    @Persisted var toys: List<Toy>
}
// ...
let dogs = myObject.mapOfDogs
let token = dogs.observe(keyPaths: ["name"]) { changes in
    switch changes {
    case .initial(let dogs):
       // ...
    case .update:
       // This case is hit:
       // - after the token is initialized
       // - when the name property of an object in the
       // collection is modified
       // - when an element is inserted or removed
       //   from the collection.
       // This block is not triggered:
       // - when a value other than name is modified on
       //   one of the elements.
    case .error:
        // ...
    }
}
// end of run loop execution context

• 確認されたキー パスが ["toys.brand"] の場合、コレクションの要素の いずれか にある toys リストへの挿入または削除によってブロックがtriggerされます。 このコレクション内の Dog にリンクされている Toy の brand 値を変更すると、ブロックがtriggerされます。 このコレクション内の Dog にリンクされている Toy の brand 以外の値を変更しても、ブロックはtriggerされません。 監視対象の Dog 型コレクションへの挿入または削除によって通知がtriggerされます。

• 上記の例で ["toys"] キー パスが確認された場合、コレクション内の任意の要素の toys リストへの挿入、削除、または変更によってブロックがtriggerされます。 このコレクション内の にリンクされているToy Dogの値を変更しても、ブロックはtrigger され ません 。監視対象の Dog 型コレクションへの挿入または削除によって通知がtriggerされます。

アップデートをブロックに送信する場合は、返されたトークンを保持する必要があります。 更新の受信を停止するには、トークンでinvalidate()を呼び出します。

このコレクションが固定されている場合は を返します

このコレクションの固定（不変）スナップショットを返します。

固定されたコピーは、このコレクションに現在含まれているデータと同じデータを含む不変のコレクションですが、含まれている Realm への書込み (write) が行われても更新されません。 ライブコレクションとは異なり、固定コレクションには任意のスレッドからアクセスできます。

この固定されたコレクションのライブ（可変）バージョンを返します。

このメソッドは、同じ固定コレクションのライブ コピーへの参照を解決します。 ライブ コレクションで呼び出されると、 は自分自身を返します。

コレクションが変更されるたびに Vid を発行する出版社。

名前に関係なく、コレクションが変更された後にこれが実際に発行します。

コレクションが変更されるたびにコレクションを発行する出版社。

指定されたプロパティ keyPaths でコレクションが変更されるたびにコレクションを発行する出版社。

コレクションが変更されるたびにコレクションの変更セットを発行する出版社。

指定されたプロパティ keyPaths でコレクションが変更されるたびにコレクションの変更セットを発行する出版社。

コレクション内のすべてのオブジェクト間で指定されたプロパティの最小（最小）値を返します。コレクションが空の場合はnilを返します。

コレクション内のすべてのオブジェクト間で指定されたプロパティの最大値（最高値）を返します。コレクションが空の場合はnilを返します。

コレクション内のオブジェクトの指定された プロパティの合計を返します。コレクションが空の場合はnilです。

コレクション内のすべてのオブジェクトにわたる指定されたプロパティの平均値を返します。コレクションが空の場合はnilを返します。

コレクション内のオブジェクトを含むResultsをソートされた状態で返します。

オブジェクトは、指定されたキー パスの値に基づいてソートされます。 たとえば、 Studentのコレクションをageプロパティに基づいて、小さいものから古い順に並べ替えるには、 students.sorted(byKeyPath: "age", ascending: true)を呼び出します。

コレクションの最小（最小）値を返します。コレクションが空の場合はnilを返します。

コレクションの最大値（最高値）を返します。コレクションが空の場合はnilを返します。

コレクション内の 値の合計を返します。コレクションが空の場合はnilを返します。

コレクション内のすべての値の平均を返します。