RealmCollection

返回与查询匹配的第一个对象的索引，如果没有对象匹配，则返回nil 。

这仅适用于有序collection，如果collection无序，则会中止。

• 用法：

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

返回与给定谓词匹配的第一个对象的索引，如果没有对象匹配，则返回nil 。

返回一个Results ，其中包含collection中与给定谓词匹配的所有对象。

注册一个区块，以便在每次collection更改时调用。

该区块将与初始结果一起异步调用，然后在每次写事务（write transaction）后再次调用，这会更改collection中的任何对象或collection中的哪些对象。

传递给区块的change参数以collection内索引的形式报告在每个写事务（write transaction）期间添加、删除或修改了哪些对象。有关所提供变更信息的更多信息，以及如何使用这些信息来更新UITableView的示例，请参阅RealmCollectionChange文档。

调用区块时，collection将进行全面求值且是最新的，只要不在同一线程上执行写事务（write transaction）或显式调用realm.refresh() ，访问该collection就永远不会执行阻塞工作。

如果未指定队列，则将通过标准事件循环传递通知，因此当事件循环被其他活动阻塞时无法传递通知。如果给出了队列，则将通知传递到该队列。 当无法立即传递通知时，可以将多个通知合并为一个通知。 这可以包括初始collection的通知。

例如，以下代码在添加通知块后立即执行写事务（write transaction），因此没有机会首先传递初始通知。因此，初始通知将反映写事务后 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] ，则对collection任何元素上的toys列表进行的任何插入或删除操作都会trigger该区块。 对链接到此collection中的Dog的任何Toy的brand值进行更改都会trigger该区块。在链接到此collection中的Dog的任何Toy上，对brand以外的值进行更改都不会trigger该区块。对所观察到的Dog类型collection的任何插入或删除也会trigger通知。

• 如果在上面的示例中观察到了[\Dog.toys]键路径，那么针对集合中的任何元素对toys列表进行的任何插入、删除或修改都会触发区块。 对链接到此collection中的Dog的任何Toy的任何值进行更改都不会trigger该区块。对正在观察的Dog类型集合的任何插入或删除仍会触发通知。

只要您希望将更新发送到区块，就必须保留返回的令牌。 要停止接收更新，请对令牌调用invalidate() 。

注册一个区块，以便在每次collection更改时调用。

该区块将与collection的初始版本一起异步调用，然后在每次写事务（write transaction）后再次调用，这会更改collection中的任何对象或collection中的哪些对象。

传递给该区块的actor参数是传递给该函数的 actor。 需要此参数来隔离对 actor 的回调。

传递给区块的change参数以collection内索引的形式报告在上次通知后添加、删除或修改了哪些对象。变更枚举中的collection字段将与请求的 actor 隔离，并且只能在该 actor 中安全使用。 有关所提供变更信息的更多信息以及如何使用这些信息来更新UITableView的示例，请参阅RealmCollectionChange文档。

发出初始通知后，该collection将进行全面评估并保持最新状态，访问该collection永远不会执行任何阻塞工作。仅当您不在通知发送到的同一 actor 上执行写事务（write transaction）时，此保证才有效。如果这样做，在传递下一个通知之前访问该collection可能需要重新运行查询。

通知将传递给给定 actor 的执行程序。 当无法立即传递通知时，可以将多个通知合并为一个通知。 这可以包括带有初始collection的通知：在传递初始通知之前发生的任何写入都可能不会生成变更通知。

在collection中添加、删除或分配对象始终会生成通知。默认情况下，修改collection链接到的对象（以及这些对象链接到的对象，如果适用）也会将collection中的索引报告为正在修改。如果提供了非空的键路径数组，则只有对这些键路径的修改才会将对象标记为已修改。 例如：

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"] ，则对collection任何元素上的toys列表进行的任何插入或删除操作都会trigger该区块。 对链接到此collection中的Dog的任何Toy的brand值进行更改都会trigger该区块。在链接到此collection中的Dog的任何Toy上，对brand以外的值进行更改都不会trigger该区块。对所观察到的Dog类型collection的任何插入或删除也会trigger通知。
• 如果在上面的示例中观察到了["toys"]键路径，那么针对集合中的任何元素对toys列表进行的任何插入、删除或修改都会触发区块。 对链接到此collection中的Dog的任何Toy的任何值进行更改都不会trigger该区块。对正在观察的Dog类型集合的任何插入或删除仍会触发通知。

只要您希望将更新发送到区块，就必须保留返回的令牌。 要停止接收更新，请对令牌调用invalidate() 。

根据指定的键路径返回包含不同对象的Results

注册一个区块，以便在每次collection更改时调用。

该区块将与初始结果一起异步调用，然后在每次写事务（write transaction）后再次调用，这会更改collection中的任何对象或collection中的哪些对象。

传递给区块的change参数以collection内索引的形式报告在每个写事务（write transaction）期间添加、删除或修改了哪些对象。有关所提供变更信息的更多信息，以及如何使用这些信息来更新UITableView的示例，请参阅RealmCollectionChange文档。

调用区块时，collection将进行全面求值且是最新的，只要不在同一线程上执行写事务（write transaction）或显式调用realm.refresh() ，访问该collection就永远不会执行阻塞工作。

如果未指定队列，则将通过标准事件循环传递通知，因此当事件循环被其他活动阻塞时无法传递通知。如果给出了队列，则将通知传递到该队列。 当无法立即传递通知时，可以将多个通知合并为一个通知。 这可以包括初始collection的通知。

例如，以下代码在添加通知块后立即执行写事务（write transaction），因此没有机会首先传递初始通知。因此，初始通知将反映写事务后 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] ，则对collection任何元素上的toys列表进行的任何插入或删除操作都会trigger该区块。 对链接到此collection中的Dog的任何Toy的brand值进行更改都会trigger该区块。在链接到此collection中的Dog的任何Toy上，对brand以外的值进行更改都不会trigger该区块。对所观察到的Dog类型collection的任何插入或删除也会trigger通知。

• 如果在上面的示例中观察到了[\Dog.toys]键路径，那么针对集合中的任何元素对toys列表进行的任何插入、删除或修改都会触发区块。 对链接到此collection中的Dog的任何Toy的任何值进行更改都不会trigger该区块。对正在观察的Dog类型集合的任何插入或删除仍会触发通知。

只要您希望将更新发送到区块，就必须保留返回的令牌。 要停止接收更新，请对令牌调用invalidate() 。

注册一个区块，以便在每次collection更改时调用。

该区块将与collection的初始版本一起异步调用，然后在每次写事务（write transaction）后再次调用，这会更改collection中的任何对象或collection中的哪些对象。

传递给该区块的actor参数是传递给该函数的 actor。 需要此参数来隔离对 actor 的回调。

传递给区块的change参数以collection内索引的形式报告在上次通知后添加、删除或修改了哪些对象。变更枚举中的collection字段将与请求的 actor 隔离，并且只能在该 actor 中安全使用。 有关所提供变更信息的更多信息以及如何使用这些信息来更新UITableView的示例，请参阅RealmCollectionChange文档。

发出初始通知后，该collection将进行全面评估并保持最新状态，访问该collection永远不会执行任何阻塞工作。仅当您不在通知发送到的同一 actor 上执行写事务（write transaction）时，此保证才有效。如果这样做，在传递下一个通知之前访问该collection可能需要重新运行查询。

通知将传递给给定 actor 的执行程序。 当无法立即传递通知时，可以将多个通知合并为一个通知。 这可以包括带有初始collection的通知：在传递初始通知之前发生的任何写入都可能不会生成变更通知。

在collection中添加、删除或分配对象始终会生成通知。默认情况下，修改collection链接到的对象（以及这些对象链接到的对象，如果适用）也会将collection中的索引报告为正在修改。如果提供了非空的键路径数组，则只有对这些键路径的修改才会将对象标记为已修改。 例如：

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] ，则对collection任何元素上的toys列表进行的任何插入或删除操作都会trigger该区块。 对链接到此collection中的Dog的任何Toy的brand值进行更改都会trigger该区块。在链接到此collection中的Dog的任何Toy上，对brand以外的值进行更改都不会trigger该区块。对所观察到的Dog类型collection的任何插入或删除也会trigger通知。
• 如果在上面的示例中观察到了[\.toys]键路径，那么针对集合中的任何元素对toys列表进行的任何插入、删除或修改都会触发区块。 对链接到此collection中的Dog的任何Toy的任何值进行更改都不会trigger该区块。对正在观察的Dog类型集合的任何插入或删除仍会触发通知。

只要您希望将更新发送到区块，就必须保留返回的令牌。 要停止接收更新，请对令牌调用invalidate() 。