Map

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

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

返回此映射中的所有键。

返回此映射中的所有值。

创建一个Map ，用于保存类型为Value的 Realm 模型对象。

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

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

将给定字典合并到此映射中，使用组合闭包确定任何重复键的值。

如果dictionary包含此映射中已存在的键，则将使用映射中当前的值和字典中的值调用combine 。 闭包返回的值将存储在该键的映射中。

将给定映射合并到此映射中，使用组合闭包确定任何重复键的值。

如果other包含此映射中已存在的键，则将使用此映射中的当前值和另一个映射中的值调用combine 。 闭包返回的值将存储在该键的映射中。

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

从地图中删除所有对象。 对象不会从管理它们的 Realm 中删除。

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

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

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

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

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

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

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

返回一个Results ，其中包含地图中与给定查询匹配的所有值。

• 用法：

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

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

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

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

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

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

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

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

返回collection中对象的属性的最大值，如果地图为空，则返回nil 。

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

返回collection中对象的属性的平均值，如果地图为空，则返回nil 。

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

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

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

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

如果未给出键路径，则在所有对象属性以及任何嵌套、链接对象的属性的任何插入、修改或删除操作时都会执行该区块。 如果提供了一个或多个关键路径，则将调用该区块以进行仅在所提供的关键路径上发生的更改。 例如，如果：

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"] ，则对collection任何元素上的toys列表进行的任何插入或删除操作都会trigger该区块。 对链接到此collection中的Dog的任何Toy的brand值进行更改都会trigger该区块。在链接到此collection中的Dog的任何Toy上，对brand以外的值进行更改都不会trigger该区块。对所观察到的Dog类型collection的任何插入或删除也会trigger通知。

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

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

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

该区块将在具有初始映射的 actor 上异步调用，然后在每次写入事务后再次调用，这会更改映射中存在的键或任何对象的值。

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

通知将传递到该 actor 执行器上与给定 actor 隔离的函数。 如果 actor 正在执行阻塞工作，则多个通知可能会合并为一个通知。 这可以包括带有初始collection的通知，并且仅报告传递初始通知后发生的写入的更改。

如果未给出键路径，则在所有对象属性以及任何嵌套、链接对象的属性的任何插入、修改或删除操作时都会执行该区块。 如果提供了一个或多个关键路径，则将调用该区块以进行仅在所提供的关键路径上发生的更改。 例如，如果：

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

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

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

该区块将在具有初始映射的 actor 上异步调用，然后在每次写入事务后再次调用，这会更改映射中存在的键或任何对象的值。

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

通知将传递到该 actor 执行器上与给定 actor 隔离的函数。 如果 actor 正在执行阻塞工作，则多个通知可能会合并为一个通知。 这可以包括带有初始collection的通知，并且仅报告传递初始通知后发生的写入的更改。

对于仅在提供的键路径上发生的更改，将调用该区块。 例如，如果：

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

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

指示Map是否被冻结。

冻结的Map是不可变的，可以从任何线程访问。 冻结的Map是通过在托管的实时Map上调用-freeze来创建的。 非托管Map永远不会被冻结。

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

冻结副本是不可变的Map ，其中包含与此Map当前包含的数据相同的数据，但在写入包含的 Realm 时不会更新。 与活动的Map不同，冻结的Map可以从任何线程访问。

返回此冻结Map的活动版本。

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

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

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

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

返回一个RLMMapIterator ，它产生Map中的连续元素。

Map 的适配器，使其成为(key: Key, value: Value)序列而不是SingleMapEntry序列。

将此 Map 作为以下项的序列返回： (key: Key, value: Value)