RealmKeyedCollection

与此collection关联的密钥类型

与此collection关联的值的类型。

管理映射的 Realm，如果映射非托管，则为nil 。

指示是否无法再访问地图。

返回此映射中键值对的数量。

Map 中包含的对象的人类可读描述。

更新存储在字典中的给定键的值，如果键不存在，则添加新的键值对。

仅当字典中存在给定键时，才删除该键及其关联对象。如果键不存在，则不会修改字典。

从字典中删除所有对象。对象不会从托管它们的 Realm 中删除。

返回给定键的值，或者在下标用于分配时为键设置值。

如果指定键存在于地图中，则返回其Value类型。

请注意，使用键值编码时，键必须是字符串。

如果指定键存在于地图中，则返回其Value类型。

将给定的键值对添加到字典中，或更新给定的键（如果已存在）。

返回一个Results ，其中包含字典中与给定谓词匹配的所有值。

返回一个布尔值，指示 Map 是否包含满足给定谓词的键值对

返回包含字典中对象的Results ，但已排序。

对象根据其值进行排序。例如，要对Date字典进行从新到旧的排序，您可以调用dates.sorted(ascending: true) 。

返回包含字典中对象的Results ，但已排序。

对象根据给定键路径的值进行排序。例如，要根据age属性对Student字典从新到旧进行排序，您可以调用students.sorted(byKeyPath: "age", ascending: true) 。

返回包含字典中对象的Results ，但已排序。

返回此字典中的所有键。

返回字典中的所有值。

返回collection中所有对象的给定属性的最小值，如果字典为空，则返回nil 。

返回字典中所有对象中给定属性的最大值，如果字典为空，则返回nil 。

返回字典中对象的给定属性的总和，如果字典为空，则返回nil 。

返回字典中所有对象的给定属性的平均值，如果字典为空，则返回nil 。

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

该区块将与初始字典一起异步调用，然后在每次更改字典中任何键或值的写事务（write transaction）后再次调用。

传递给区块的change参数以字典中键的形式报告在每个写事务期间添加、删除或修改了哪些键值对。

在调用区块时，字典将被完全评估并保持最新状态，只要您不在同一线程上执行写事务（write transaction）或显式调用realm.refresh() ，访问它就永远不会执行阻塞工作。

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

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

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

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

如果此collection已冻结，则返回

返回此collection的冻结（不可变）快照。

冻结副本是一个不可变的collection，其中包含与该collection当前包含的数据相同的数据，但在写入包含的 Realm 时不会更新。与实时集合不同，冻结集合可以从任何线程访问。

返回此冻结collection的活动（可变）版本。

此方法解析对同一冻结collection的实时副本的引用。如果在实时collection上调用，则返回自身。

每次collection更改时发出 Void 的发布者。

尽管有这个名称，但它实际上是在collection发生更改后发出的。

每次集合更改时发出集合的发布者。

每当给定属性 keyPaths 上的collection发生变更时，发布者都会发出该collection。

每次集合更改时发出集合变更集的发布者。

每次集合在给定属性 keyPaths 上发生更改时发出集合变更集的发布者。

返回集合中所有对象中给定属性的最小值，如果集合为空，则返回nil 。

返回集合中所有对象中给定属性的最大值，如果集合为空，则返回nil 。

返回集合中对象的给定属性的总和，如果集合为空，则返回nil 。

返回集合中所有对象的给定属性的平均值，如果集合为空，则返回nil 。

返回包含collection中的对象的Results ，但已排序。

对象根据给定键路径的值进行排序。 例如，要根据Student age属性对collection从新到旧进行排序，您可以调用students.sorted(byKeyPath: "age", ascending: true) 。

返回集合的最小值；如果集合为空，则返回nil 。

返回集合的最大值，如果集合为空，则返回nil 。

返回集合中值的总和，如果集合为空，则返回nil 。

返回集合中所有值的平均值。