Map

O Realm que gerencia o mapa, ou nil se o mapa não for gerenciado.

Indica se o mapa não pode mais ser acessado.

Retorna todas as chaves neste mapa.

Retorna todos os valores neste mapa.

Cria um Map que contém objetos de modelo de Realm do tipo Value.

Retorna o número de pares de valores-chave neste mapa.

Atualiza o valor armazenado no mapa para a chave fornecida ou adiciona um novo par chave-valor se a chave não existir.

Mesclar o dicionário fornecido neste mapa, utilizando um fechamento de combinação para determinar o valor para quaisquer chaves duplicadas.

Se dictionary contiver uma chave que já esteja presente neste mapa, combine será chamado com o valor atualmente no mapa e o valor no dicionário. O valor retornado pelo fechamento será armazenado no mapa para esta chave.

Mesclar o mapa fornecido neste mapa, utilizando um fechamento de combinação para determinar o valor para quaisquer chaves duplicadas.

Se other contiver uma chave que já esteja presente neste mapa, combine será chamado com o valor atualmente no mapa e o valor no outro mapa. O valor retornado pelo fechamento será armazenado no mapa para esta chave.

Remove a chave fornecida e seu objeto associado, somente se a chave existir no mapa. Se a chave não existir, o mapa não será modificado.

Remove todos os objetos do mapa. O objeto não é removido do Realm que managed eles.

Retorna o valor de uma determinada chave ou define um valor para uma chave caso o índice seja usado para uma atribuição.

Retorna um tipo de AnyObject para uma chave especificada se ela existir no mapa.

Retorna um tipo de Value para uma chave especificada se ela existir no mapa.

Observe que, ao usar a codificação key-value, a chave deve ser uma string.

Retorna um tipo de Value para uma chave especificada se ela existir no mapa.

Adiciona um determinado par de chave-valor ao mapa ou atualiza uma determinada chave caso ela já exista.

Retorna um Results contendo todos os valores correspondentes no mapa com o predicado fornecido.

Retorna um Results contendo todos os valores correspondentes no mapa com a query fornecida.

• Uso:

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

Retorna um valor booleano que indica se o Mapa contém o par de valores-chave que satisfaz o predicado fornecido

Retorna um Results contendo os objetos no mapa, mas ordenados.

objeto são classificados com base em seus valores. Por exemplo, para classificar um mapa de Dates do mais recente para o mais antigo, você pode chamar dates.sorted(ascending: true).

Retorna um Results contendo os objetos no mapa, mas ordenados.

Os objetos são classificados com base nos valores do caminho de chave fornecido. Por exemplo, para classificar um mapa de Students do mais novo para o mais antigo com base em sua propriedade age , você pode chamar students.sorted(byKeyPath: "age", ascending: true).

Retorna um Results contendo os objetos no mapa, mas ordenados.

Retorna o valor mínimo (mais baixo) da propriedade fornecida entre todos os objeto na collection ou nil se o mapa estiver vazio.

Retorna o valor máximo (mais alto) da propriedade fornecida entre todos os objetos na collection, ou nil se o mapa estiver vazio.

Retorna a soma da propriedade fornecida para objetos na collection ou nil se o mapa estiver vazio.

Retorna o valor médio de uma determinada propriedade sobre todos os objeto na collection ou nil se o mapa estiver vazio.

Registra um bloco a ser chamado cada vez que o mapa for alterado.

O bloco será chamado de forma assíncrona com o mapa inicial e, em seguida, chamado novamente após cada transação de escrita que altere qualquer uma das chaves ou valores no mapa.

O parâmetro change que é passado para o bloco reporta, na forma de chaves dentro do mapa, quais dos pares de chave-valor foram adicionados, removidos ou modificados durante cada transação de escrita.

Se nenhuma fila for fornecida, as notificações serão entregues por meio do loop de execução padrão e, portanto, não poderão ser entregues enquanto o loop de execução estiver bloqueado por outra atividade. Se uma fila for fornecida, as notificações serão entregues para essa fila. Quando as notificações não podem ser entregues instantaneamente, várias notificações podem ser agrupadas em uma única notificação. Isso pode incluir a notificação com a coleção inicial.

Por exemplo, o código a seguir executa uma transação de escrita imediatamente após adicionar o bloqueio de notificação, para que não haja oportunidade para que a notificação inicial seja entregue primeiro. Como resultado, a notificação inicial refletirá o estado do Realm após a transação de escrita.

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"
}

Se nenhum caminho-chave for fornecido, o bloqueio será executado em qualquer inserção, modificação ou exclusão para todas as propriedades do objeto e as propriedades de quaisquer objetos vinculados aninhados. Se um caminho de chave ou caminhos de chave forem fornecidos, o bloco será chamado para alterações que ocorrem apenas nos caminhos de chave fornecidos. Por exemplo, se:

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:
        // ...
    }
}

• Se o caminho da chave observado fosse ["toys.brand"], qualquer inserção ou exclusão na lista toys em qualquer um dos elementos da collection trigger o bloqueio. Alterações no valor brand em qualquer Toy vinculado a um Dog nessa collection triggerão o bloqueio. Alterações em um valor diferente de brand em qualquer Toy vinculado a um Dog nessa collection não trigger o bloqueio. Qualquer inserção ou remoção na collection de tipos Dog que está sendo observada também trigger uma notificação.

• Se o exemplo acima observasse o caminho da chave ["toys"], qualquer inserção, exclusão ou modificação na lista toys para qualquer elemento da collection trigger o bloqueio. Alterações em qualquer valor em qualquer Toy que esteja vinculado a um Dog nesta collection não trigger o bloqueio. Qualquer inserção ou remoção na collection de tipos Dog que está sendo observada ainda trigger uma notificação.

Você deve reter o token retornado pelo tempo que desejar que as atualizações sejam enviadas ao bloco. Para parar de receber atualizações, ligue para invalidate() no token.

Registra um bloco a ser chamado cada vez que o mapa for alterado.

O bloco será chamado de forma assíncrona no ator com o mapa inicial e, em seguida, chamado novamente após cada transação de gravação, o que altera quais chaves estão presentes no mapa ou os valores de qualquer um dos objetos.

O parâmetro change que é passado para o bloco reporta, na forma de chaves dentro do mapa, quais dos pares de chave-valor foram adicionados, removidos ou modificados durante cada transação de escrita.

As notificações são entregues para uma função isolada para o ator fornecido, nesse executor de atores. Se o ator estiver realizando um trabalho de bloqueio, várias notificações poderão ser agrupadas em uma única notificação. Isso pode incluir a notificação com a collection inicial, e as alterações são relatadas apenas para gravações que ocorrem após a entrega da notificação inicial.

Se nenhum caminho-chave for fornecido, o bloqueio será executado em qualquer inserção, modificação ou exclusão para todas as propriedades do objeto e as propriedades de quaisquer objetos vinculados aninhados. Se um caminho de chave ou caminhos de chave forem fornecidos, o bloco será chamado para alterações que ocorrem apenas nos caminhos de chave fornecidos. Por exemplo, se:

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
    }
}

• Se o caminho da chave observado fosse ["toys.brand"], qualquer inserção ou exclusão na lista toys em qualquer um dos elementos da collection trigger o bloqueio. Alterações no valor brand em qualquer Toy vinculado a um Dog nessa collection triggerão o bloqueio. Alterações em um valor diferente de brand em qualquer Toy vinculado a um Dog nessa collection não trigger o bloqueio. Qualquer inserção ou remoção na collection de tipos Dog que está sendo observada também trigger uma notificação.
• Se o exemplo acima observasse o caminho da chave ["toys"], qualquer inserção, exclusão ou modificação na lista toys para qualquer elemento da collection trigger o bloqueio. Alterações em qualquer valor em qualquer Toy que esteja vinculado a um Dog nesta collection não trigger o bloqueio. Qualquer inserção ou remoção na collection de tipos Dog que está sendo observada ainda trigger uma notificação.

Você deve reter o token retornado pelo tempo que desejar que as atualizações sejam enviadas ao bloco. Para parar de receber atualizações, ligue para invalidate() no token.

Registra um bloco a ser chamado cada vez que o mapa for alterado.

O bloco será chamado de forma assíncrona no ator com o mapa inicial e, em seguida, chamado novamente após cada transação de gravação, o que altera quais chaves estão presentes no mapa ou os valores de qualquer um dos objetos.

O parâmetro change que é passado para o bloco reporta, na forma de chaves dentro do mapa, quais dos pares de chave-valor foram adicionados, removidos ou modificados durante cada transação de escrita.

As notificações são entregues para uma função isolada para o ator fornecido, nesse executor de atores. Se o ator estiver realizando um trabalho de bloqueio, várias notificações poderão ser agrupadas em uma única notificação. Isso pode incluir a notificação com a collection inicial, e as alterações são relatadas apenas para gravações que ocorrem após a entrega da notificação inicial.

O bloco será chamado para alterações que ocorrem apenas nos caminhos-chave fornecidos. Por exemplo, se:

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
    }
}

• Se o caminho da chave observado fosse [\.toys.brand], qualquer inserção ou exclusão na lista toys em qualquer um dos elementos da collection trigger o bloqueio. Alterações no valor brand em qualquer Toy vinculado a um Dog nessa collection triggerão o bloqueio. Alterações em um valor diferente de brand em qualquer Toy vinculado a um Dog nessa collection não trigger o bloqueio. Qualquer inserção ou remoção na collection de tipos Dog que está sendo observada também trigger uma notificação.
• Se o exemplo acima observasse o caminho da chave [\.toys], qualquer inserção, exclusão ou modificação na lista toys para qualquer elemento da collection trigger o bloqueio. Alterações em qualquer valor em qualquer Toy que esteja vinculado a um Dog nesta collection não trigger o bloqueio. Qualquer inserção ou remoção na collection de tipos Dog que está sendo observada ainda trigger uma notificação.

Você deve reter o token retornado pelo tempo que desejar que as atualizações sejam enviadas ao bloco. Para parar de receber atualizações, ligue para invalidate() no token.

Indica se o Map está congelado.

Maps congelados são imutáveis e podem ser acessados de qualquer thread. Maps congelados são criados chamando -freeze em um Map ativo managed. Maps não gerenciados nunca são congelados.

Retorna um snapshot congelado (imutável) de um Map.

A cópia congelada é um Map imutável que contém os mesmos dados que este Map contém atualmente, mas não será atualizado quando forem feitas gravações no Realm que a contém. Ao contrário dos Map Mapcongelados podem ser acessados de qualquer thread.

Retorna uma versão ativa deste Map congelado.

Este método resolve uma referência a uma cópia ativa do mesmo Map congelado. Se chamado em um Map ao vivo, se retornará.

Retorna uma descrição legível por humanos dos objetos contidos no Mapa.

Uma editora que emite um vazio toda vez que a collection muda.

Apesar do nome, isso na verdade é emitido após a mudança da collection.

Retorna um RLMMapIterator que produz elementos sucessivos no Map.

Um adaptador para Map que o torna uma sequência de (key: Key, value: Value) em vez de uma sequência de SingleMapEntry.

Retorna este Mapa como uma sequência de (key: Key, value: Value)