RealmCollection

Retorna o índice do primeiro objeto que corresponde à query ou nil se nenhum objeto corresponder.

Isso só é aplicável a collection ordenadas e será abortado se a collection não estiver ordenada.

• Uso:

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

Retorna o índice do primeiro objeto que corresponde ao predicado fornecido ou nil se nenhum objeto corresponder.

Retorna um Results contendo todos os objetos que correspondem ao predicado fornecido na coleção.

Registra um bloco a ser chamado cada vez que a collection for alterada.

O bloco será chamado de forma assíncrona com os resultados iniciais e, em seguida, chamado novamente após cada transação de gravação que altere qualquer um dos objetos da coleção ou quais objetos estão na coleção.

O parâmetro change que é passado para o bloco reporta, na forma de índices dentro da collection, quais dos objetos foram adicionados, removidos ou modificados durante cada transação de escrita. Consulte a documentação do RealmCollectionChange para obter mais informações sobre as informações de alteração fornecidas e um exemplo de como usá-las para atualizar um UITableView .

No momento em que o bloqueio for chamado, a coleção será totalmente avaliada e atualizada e, desde que você não execute uma transação de gravação na mesma thread ou chame explicitamente realm.refresh() , acessá-la nunca executará o bloqueio trabalho.

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

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

• Se o caminho da chave observado fosse [\Dog.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 [\Dog.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 a collection for alterada.

O bloco será chamado de forma assíncrona com uma versão inicial da coleção e, em seguida, chamado novamente após cada transação de gravação que altere qualquer um dos objetos da coleção ou quais objetos estão na coleção.

O parâmetro actor passado para o bloco é o ator que você passa para esta função. Este parâmetro é necessário para isolar a chamada de resposta para o ator.

O parâmetro change que é passado para o bloco reporta, na forma de índices dentro da collection, quais dos objetos foram adicionados, removidos ou modificados após a notificação anterior. O campo collection na enumeração de alteração será isolado para o ator solicitado e é seguro para uso somente dentro desse ator. Consulte a documentação do RealmCollectionChange para obter mais informações sobre as informações de alteração fornecidas e um exemplo de como usá-las para atualizar um UITableView.

Depois que a notificação inicial for entregue, a coleção será totalmente avaliada e atualizada, e acessá-la nunca realizará nenhum trabalho de bloqueio. Essa garantia é válida apenas enquanto você não realizar uma transação de escrita no mesmo ator para o qual as notificações estão sendo entregues. Se você fizer isso, para acessar a coleção antes da próxima notificação ser entregue, talvez seja necessário executar novamente a query.

As notificações são entregues ao executor do ator em questão. 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 collection inicial: quaisquer gravações que ocorram antes da entrega da notificação inicial podem não produzir notificações de alteração.

Adicionar, remover ou atribuir objetos na coleção sempre produz uma notificação. Por padrão, modificar os objetos aos quais uma coleção está vinculada (e os objetos aos quais esses objetos se vinculam, se aplicável) também informará que esse índice na coleção está sendo modificado. Se uma array não vazia de keypaths for fornecida, somente as modificações nesses keypaths marcarão o objeto como modificado. Por exemplo:

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

• 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.

Retorna um Results contendo objetos distintos com base nos caminhos de chave especificados

Registra um bloco a ser chamado cada vez que a collection for alterada.

O bloco será chamado de forma assíncrona com os resultados iniciais e, em seguida, chamado novamente após cada transação de gravação que altere qualquer um dos objetos da coleção ou quais objetos estão na coleção.

O parâmetro change que é passado para o bloco reporta, na forma de índices dentro da collection, quais dos objetos foram adicionados, removidos ou modificados durante cada transação de escrita. Consulte a documentação do RealmCollectionChange para obter mais informações sobre as informações de alteração fornecidas e um exemplo de como usá-las para atualizar um UITableView .

No momento em que o bloqueio for chamado, a coleção será totalmente avaliada e atualizada e, desde que você não execute uma transação de gravação na mesma thread ou chame explicitamente realm.refresh() , acessá-la nunca executará o bloqueio trabalho.

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

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

• Se o caminho da chave observado fosse [\Dog.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 [\Dog.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 a collection for alterada.

O bloco será chamado de forma assíncrona com uma versão inicial da coleção e, em seguida, chamado novamente após cada transação de gravação que altere qualquer um dos objetos da coleção ou quais objetos estão na coleção.

O parâmetro actor passado para o bloco é o ator que você passa para esta função. Este parâmetro é necessário para isolar a chamada de resposta para o ator.

O parâmetro change que é passado para o bloco reporta, na forma de índices dentro da collection, quais dos objetos foram adicionados, removidos ou modificados após a notificação anterior. O campo collection na enumeração de alteração será isolado para o ator solicitado e é seguro para uso somente dentro desse ator. Consulte a documentação do RealmCollectionChange para obter mais informações sobre as informações de alteração fornecidas e um exemplo de como usá-las para atualizar um UITableView.

Depois que a notificação inicial for entregue, a coleção será totalmente avaliada e atualizada, e acessá-la nunca realizará nenhum trabalho de bloqueio. Essa garantia é válida apenas enquanto você não realizar uma transação de escrita no mesmo ator para o qual as notificações estão sendo entregues. Se você fizer isso, para acessar a coleção antes da próxima notificação ser entregue, talvez seja necessário executar novamente a query.

As notificações são entregues ao executor do ator em questão. 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 collection inicial: quaisquer gravações que ocorram antes da entrega da notificação inicial podem não produzir notificações de alteração.

Adicionar, remover ou atribuir objetos na coleção sempre produz uma notificação. Por padrão, modificar os objetos aos quais uma coleção está vinculada (e os objetos aos quais esses objetos se vinculam, se aplicável) também informará que esse índice na coleção está sendo modificado. Se uma array não vazia de keypaths for fornecida, somente as modificações nesses keypaths marcarão o objeto como modificado. Por exemplo:

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

• 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.