Map

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

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

このマップ内のすべてのキーを返します。

このマップ内のすべての値を返します。

タイプValueの Realm モデル オブジェクトを保持するMapを作成します。

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

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

結合閉じる を使用して重複キーの値を決定し、指定された辞書をこのマップにマージします。

このマップにすでに存在するキーがdictionaryに含まれている場合、マップに現在ある値と辞書にある値を使用してcombineが呼び出されます。 閉じるによって返された値は、そのキーのマップに保存されます。

指定されたマップをこのマップにマージし、重複するキーの値を決定するために結合されます。

このマップにすでに存在するキーがotherに含まれている場合、マップに現在ある値と他のマップにある値を使用してcombineが呼び出されます。 閉じるによって返された値は、そのキーのマップに保存されます。

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

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

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

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

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

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

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

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

指定された述語を持つマップ内のすべての一致する値を含むResultsを返します。

指定されたクエリに一致するマップ内のすべての値を含むResultsを返します。

• 使用法:

  myMap.where {
  ($0.fooCol > 5) && ($0.barCol == "foobar")
  }
  

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

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

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

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

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

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

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

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

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

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

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

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

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

キューが指定されていない場合、通知は標準の実行ループを介して配信されるため、実行ループが他のアクティビティによってブロックされている間は通知を配信できません。 キューが指定されている場合、代わりにそのキューに通知が配信されます。 通知をすぐに配信できない場合は、複数の通知が 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"
}

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

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:
        // ...
    }
}

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

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

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

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

ブロックは最初のマップを持つアクターで非同期に呼び出され、マップに存在するキーまたは オブジェクトの値のいずれかを変更する書き込みトランザクションごとに再度呼び出されます。

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

通知は、指定されたアクターの実行プログラム上の、そのアクターに分離された関数に配信されます。 アクターがブロッキング作業を実行している場合、複数の通知が 1 つの通知に統合されることがあります。 これには初期コレクションの通知を含めることができ、変更は最初の通知が配信された後に発生した書き込みについてのみ報告されます。

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

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"], on: actor) { actor, 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:
        // No longer possible and left for backwards compatibility
    }
}

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

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

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

ブロックは最初のマップを持つアクターで非同期に呼び出され、マップに存在するキーまたは オブジェクトの値のいずれかを変更する書き込みトランザクションごとに再度呼び出されます。

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

通知は、指定されたアクターの実行プログラム上の、そのアクターに分離された関数に配信されます。 アクターがブロッキング作業を実行している場合、複数の通知が 1 つの通知に統合されることがあります。 これには初期コレクションの通知を含めることができ、変更は最初の通知が配信された後に発生した書き込みについてのみ報告されます。

ブロックは、指定されたキー パスでのみ発生する変更に対して呼び出されます。 たとえば、次の場合:

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], on: actor) { actor, 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:
        // No longer possible and left for backwards compatibility
    }
}

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

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

Mapが固定されているかどうかを示します。

凍結されたMapは不変であり、どのスレッドからでもアクセスできます。 凍結されたMapは、管理対象のライブMapで-freezeを呼び出すことで作成されます。 管理されていないMapは固定されません。

Mapの固定（不変）スナップショットを返します。

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

この固定されたMapのライブ バージョンを返します。

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

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

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

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

Mapで連続する要素を生成するRLMMapIteratorを返します。

Map のアダプター。これにより、 SingleMapEntryのシーケンスではなく(key: Key, value: Value)のシーケンスになります。

このマップを次のシーケンスとして返します: (key: Key, value: Value)