RealmCollection

クエリに一致する最初のオブジェクトのインデックスを返します。一致するオブジェクトがない場合はnilを返します。

これは、順序付きコレクションにのみ適用され、コレクションが順序付けられていない場合は中止されます。

• 使用法:

  obj.index(matching: { $0.fooCol < 456 })
  

指定された述語に一致する最初のオブジェクトのインデックスを返します。一致するオブジェクトがない場合はnilを返します。

コレクション内の指定された述語に一致するすべてのオブジェクトを含むResultsを返します。

コレクションが変更されるたびに呼び出されるブロックを登録します。

ブロックは初期結果とは非同期に呼び出され、コレクション内のいずれかのオブジェクトまたはコレクション内のどのオブジェクトのいずれかを変更する書込みトランザクションごとに再度呼び出されます。

ブロックに渡されるchangeパラメータは、各書込みトランザクション中に追加、削除、または変更されたオブジェクトをコレクション内のインデックスの形式で報告します。 提供される変更情報の詳細と、その変更情報を使用してUITableViewをアップデートする方法の例については、 RealmCollectionChangeのドキュメントを参照してください。

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

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

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

let dogs = realm.objects(Dog.self)
print("dogs.count: \(dogs?.count)") // => 0
let token = dogs.observe { changes in
    switch changes {
    case .initial(let dogs):
        // Will print "dogs.count: 1"
        print("dogs.count: \(dogs.count)")
        break
    case .update:
        // Will not be hit in this example
        break
    case .error:
        break
    }
}
try! realm.write {
    let dog = Dog()
    dog.name = "Rex"
    person.dogs.append(dog)
}
// end of run loop execution context

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

class Dog: Object {
    @Persisted var name: String
    @Persisted var age: Int
    @Persisted var toys: List<Toy>
}
// ...
let dogs = realm.objects(Dog.self)

let token = dogs.observe(keyPaths: [\Dog.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

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

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

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

コレクションが変更されるたびに呼び出されるブロックを登録します。

ブロックはコレクションの初期バージョンと非同期に呼び出され、コレクション内のいずれかのオブジェクトまたはコレクション内のどのオブジェクトのいずれかを変更する各書込みトランザクションの後に再度呼び出されます。

ブロックに渡されるactorパラメータは、この関数に渡すアクターです。 このパラメーターは、アクターへのコールバックを分離するために必要です。

ブロックに渡されるchangeパラメータは、前回の通知後に追加、削除、または変更されたオブジェクトをコレクション内のインデックスの形式で報告します。 変更列挙のcollectionフィールドは要求されたアクターに分離され、そのアクター内でのみ安全に使用できます。 提供される変更情報の詳細と、その変更情報を使用してUITableViewを更新する方法の例については、 RealmCollectionChangeのドキュメントを参照してください。

最初の通知が配信されると、コレクションは完全に評価されて最新になり、このコレクションにアクセスしてもブロッキング作業は実行されません。 この保証は、通知が配信されるのと同じアクターで書込みトランザクションを実行しない場合にのみ有効です。 その場合、次の通知が配信される前にコレクションにアクセスするには、クエリを再実行する必要がある可能性があります。

通知は指定されたアクターの実行プログラムに配信されます。 通知をすぐに配信できない場合は、複数の通知が 1 つの通知に統合されることがあります。 これには、初期コレクションの通知を含めることができます。最初の通知が配信される前に発生する書き込みでは、変更通知が生成されない可能性があります。

コレクション内のオブジェクトを追加、削除、または割り当てると常に通知が生成されます。 デフォルトでは、コレクションがリンクするオブジェクト（およびそれらのオブジェクトがリンクするオブジェクト（該当する場合）を変更すると、コレクション内のそのインデックスも変更されていることが報告されます。 キーパスの空でない配列が指定されている場合、それらのキーパスに対する変更のみによってオブジェクトは変更済みとしてマークされます。 例:

class Dog: Object {
    @Persisted var name: String
    @Persisted var age: Int
    @Persisted var toys: List<Toy>
}

let dogs = realm.objects(Dog.self)
let token = await dogs.observe(keyPaths: ["name"], on: myActor) { actor, changes in
    switch changes {
    case .initial(let dogs):
        // Query has finished running and dogs can not be used without blocking
    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:
        // Can no longer happen but is left for backwards compatiblity
    }
}

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

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

指定されたキー パスに基づいて個別のオブジェクトを含むResultsを返します

コレクションが変更されるたびに呼び出されるブロックを登録します。

ブロックは初期結果とは非同期に呼び出され、コレクション内のいずれかのオブジェクトまたはコレクション内のどのオブジェクトのいずれかを変更する書込みトランザクションごとに再度呼び出されます。

ブロックに渡されるchangeパラメータは、各書込みトランザクション中に追加、削除、または変更されたオブジェクトをコレクション内のインデックスの形式で報告します。 提供される変更情報の詳細と、その変更情報を使用してUITableViewをアップデートする方法の例については、 RealmCollectionChangeのドキュメントを参照してください。

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

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

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

let dogs = realm.objects(Dog.self)
print("dogs.count: \(dogs?.count)") // => 0
let token = dogs.observe { changes in
    switch changes {
    case .initial(let dogs):
        // Will print "dogs.count: 1"
        print("dogs.count: \(dogs.count)")
        break
    case .update:
        // Will not be hit in this example
        break
    case .error:
        break
    }
}
try! realm.write {
    let dog = Dog()
    dog.name = "Rex"
    person.dogs.append(dog)
}
// end of run loop execution context

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

class Dog: Object {
    @Persisted var name: String
    @Persisted var age: Int
    @Persisted var toys: List<Toy>
}
// ...
let dogs = realm.objects(Dog.self)

let token = dogs.observe(keyPaths: [\Dog.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

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

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

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

コレクションが変更されるたびに呼び出されるブロックを登録します。

ブロックはコレクションの初期バージョンと非同期に呼び出され、コレクション内のいずれかのオブジェクトまたはコレクション内のどのオブジェクトのいずれかを変更する各書込みトランザクションの後に再度呼び出されます。

ブロックに渡されるactorパラメータは、この関数に渡すアクターです。 このパラメーターは、アクターへのコールバックを分離するために必要です。

ブロックに渡されるchangeパラメータは、前回の通知後に追加、削除、または変更されたオブジェクトをコレクション内のインデックスの形式で報告します。 変更列挙のcollectionフィールドは要求されたアクターに分離され、そのアクター内でのみ安全に使用できます。 提供される変更情報の詳細と、その変更情報を使用してUITableViewを更新する方法の例については、 RealmCollectionChangeのドキュメントを参照してください。

最初の通知が配信されると、コレクションは完全に評価されて最新になり、このコレクションにアクセスしてもブロッキング作業は実行されません。 この保証は、通知が配信されるのと同じアクターで書込みトランザクションを実行しない場合にのみ有効です。 その場合、次の通知が配信される前にコレクションにアクセスするには、クエリを再実行する必要がある可能性があります。

通知は指定されたアクターの実行プログラムに配信されます。 通知をすぐに配信できない場合は、複数の通知が 1 つの通知に統合されることがあります。 これには、初期コレクションの通知を含めることができます。最初の通知が配信される前に発生する書き込みでは、変更通知が生成されない可能性があります。

コレクション内のオブジェクトを追加、削除、または割り当てると常に通知が生成されます。 デフォルトでは、コレクションがリンクするオブジェクト（およびそれらのオブジェクトがリンクするオブジェクト（該当する場合）を変更すると、コレクション内のそのインデックスも変更されていることが報告されます。 キーパスの空でない配列が指定されている場合、それらのキーパスに対する変更のみによってオブジェクトは変更済みとしてマークされます。 例:

class Dog: Object {
    @Persisted var name: String
    @Persisted var age: Int
    @Persisted var toys: List<Toy>
}

let dogs = realm.objects(Dog.self)
let token = await dogs.observe(keyPaths: [\.name], on: myActor) { actor, changes in
    switch changes {
    case .initial(let dogs):
        // Query has finished running and dogs can not be used without blocking
    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:
        // Can no longer happen but is left for backwards compatiblity
    }
}

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

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