ProjectedCollection

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

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

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

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

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

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

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

class Person: Object {
    @Persisted var dogs: List<Dog>
}
class PersonProjection: Projection<Person> {
    @Projected(\Person.dogs.projectTo.name) var dogsNames: ProjectedCollection<String>
}
// ...
let dogsNames = personProjection.dogsNames
print("dogsNames.count: \(dogsNames?.count)") // => 0
let token = dogsNames.observe { changes in
    switch changes {
    case .initial(let dogsNames):
        // Will print "dogsNames.count: 1"
        print("dogsNames.count: \(dogsNames.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

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

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

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

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

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

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

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

class Person: Object {
    @Persisted var dogs: List<Dog>
}
class PersonProjection: Projection<Person> {
    @Projected(\Person.dogs.projectTo.name) var dogNames: ProjectedCollection<String>
}
// ...
let dogNames = personProjection.dogNames
print("dogNames.count: \(dogNames?.count)") // => 0
let token = dogs.observe { changes in
    switch changes {
    case .initial(let dogNames):
        // Will print "dogNames.count: 1"
        print("dogNames.count: \(dogNames.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 Person: Object {
    @Persisted var dogs: List<Dog>
}
class PersonProjection: Projection<Person> {
    @Projected(\Person.dogs.projectTo.name) var dogNames: ProjectedCollection<String>
}
// ...
let dogNames = personProjection.dogNames
let token = dogNames.observe(keyPaths: ["name"]) { changes in
    switch changes {
    case .initial(let dogNames):
       // ...
    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

このコレクション内の にリンクされている他の値を変更しても、ブロックはDogtrigger され ません 。監視対象の Dog 型コレクションへの挿入または削除によって通知がtriggerされます。

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

指定されたインデックスのオブジェクトを返します（get）、または指定されたインデックスのオブジェクトを置き換えます（set）。

空でないコレクション内の最初の要素の位置。 空のコレクション内の endIndex と同じ。

コレクションの「終了を過ぎた」位置。 endIndex はサブスクリプトへの有効な引数ではなく、成功します（）の 0 個以上のアプリケーションによって startIndex から常にアクセス可能です。

オブジェクトを管理する Realm。

コレクションがアクセスできなくなっているかどうかを示します。

人間が判読可能なオブジェクトの説明。

リンク オブジェクト内のオブジェクトのインデックスを返します。オブジェクトが存在しない場合はnilを返します。