Pacote io.realm

Classe RealmQuery<E>

  • Parâmetros do tipo:
    E - a classe do objeto a serem query.
    public class RealmQuery<E>
extends Object
    Um RealmQuery encapsula uma query em um Realm ou RealmResults usando o padrão Builder. A query é executada usando findAll() ou findFirst().

    A entrada de muitas das funções de query usa um nome de campo como String. Observe que isso não é seguro para o tipo. Se uma classe RealmObject for refatorada, deve-se ter cuidado para não interromper nenhuma query.

    Um Realm não está ordenado, o que significa que não há garantia de que a query de um Realm retorne os objetos na ordem em que foram inseridos. Use sort(String) (String)} e métodos semelhantes se uma ordem específica for necessária.

    Uma RealmQuery não pode ser passada entre threads diferentes.

    Os resultados são obtidos rapidamente na maioria das vezes. No entanto, o lançamento de queries pesadas a partir do thread da UI pode resultar em uma queda de armações ou até mesmo em ANRs. Se quiser evitar esses comportamentos, você pode instanciar um Realm usando um RealmConfiguration que define explicitamente RealmConfiguration.Builder.allowQueriesOnUiThread(boolean) como false. Dessa forma, as queries serão forçadas a serem lançadas a partir de um thread que não seja da interface do usuário. Como alternativa, você também pode usar findAllAsync() ou findFirstAsync().

    Veja também:
    Padrão do construtor, Realm.where(Class), RealmResults.where()

    • Detalhes do método

      • é válido

        public boolean isValid()
        Verifica se RealmQuery ainda é válido para uso, ou seja, a instância Realm não foi fechada e qualquer RealmResults pai ainda é válido.
        Retorna:
        true se ainda for válido para usar, false caso contrário.

      • IsNull

        public RealmQuery<E> isNull​(String fieldName)
        Testa se um campo é null. Funciona apenas para campos anuláveis.

        Para query de link, se qualquer parte do caminho do link for null , todo o caminho será considerado null por exemplo, isNull("linkField.stringField") será considerado null se linkField ou linkField.stringField for null.

        Parâmetros:
        fieldName - o nome do campo.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o campo não for anulável.
        Veja também:
        for further infomation.

      • EqualTo

        public RealmQuery<E> equalTo​(String fieldName,
                             @Nullable
                             String value)
        Comparação igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • EqualTo

        public RealmQuery<E> equalTo​(String fieldName,
                             @Nullable
                             String value,
                             Case casing)
        Comparação igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        casing - como lidar com o invólucro. Definir isso como Case.INSENSITIVE só funciona com caracteres Latin-1.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • EqualTo

        public RealmQuery<E> equalTo​(String fieldName,
                             RealmAny value,
                             Case casing)
        Comparação igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        casing - como lidar com o invólucro. Definir isso como Case.INSENSITIVE só funciona com caracteres Latin-1.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • EqualTo

        public RealmQuery<E> equalTo​(String fieldName,
                             @Nullable
                             Decimal128 value)
        Comparação igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • EqualTo

        public RealmQuery<E> equalTo​(String fieldName,
                             @Nullable
                             ObjectId value)
        Comparação igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • EqualTo

        public RealmQuery<E> equalTo​(String fieldName,
                             @Nullable
                             UUID value)
        Comparação igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • EqualTo

        public RealmQuery<E> equalTo​(String fieldName,
                             @Nullable
                             Byte value)
        Comparação igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • EqualTo

        public RealmQuery<E> equalTo​(String fieldName,
                             @Nullable
                             byte[] value)
        Comparação igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • EqualTo

        public RealmQuery<E> equalTo​(String fieldName,
                             @Nullable
                             Short value)
        Comparação igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • EqualTo

        public RealmQuery<E> equalTo​(String fieldName,
                             @Nullable
                             Integer value)
        Comparação igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • EqualTo

        public RealmQuery<E> equalTo​(String fieldName,
                             @Nullable
                             Long value)
        Comparação igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • EqualTo

        public RealmQuery<E> equalTo​(String fieldName,
                             @Nullable
                             Double value)
        Comparação igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • EqualTo

        public RealmQuery<E> equalTo​(String fieldName,
                             @Nullable
                             Float value)
        Comparação igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        O objeto de consulta.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • EqualTo

        public RealmQuery<E> equalTo​(String fieldName,
                             @Nullable
                             Boolean value)
        Comparação igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • EqualTo

        public RealmQuery<E> equalTo​(String fieldName,
                             @Nullable
                             Date value)
        Comparação igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • EqualTo

        public RealmQuery<E> equalTo​(String fieldName,
                             RealmAny value)
        Comparação igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Em

        public RealmQuery<E> in​(String fieldName,
                        @Nullable
                        String[] values)
        Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.
        Parâmetros:
        fieldName - o campo para comparar.
        values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o campo não for um campo String .

      • Em

        public RealmQuery<E> in​(String fieldName,
                        @Nullable
                        String[] values,
                        Case casing)
        Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.
        Parâmetros:
        fieldName - o campo para comparar.
        values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.
        casing - como o invólucro é tratado. Case.INSENSITIVE funciona apenas para os caracteres Latin-1.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o campo não for um campo String .

      • Em

        public RealmQuery<E> in​(String fieldName,
                        @Nullable
                        Byte[] values)
        Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.
        Parâmetros:
        fieldName - o campo para comparar.
        values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o campo não for um campo de Byte .

      • Em

        public RealmQuery<E> in​(String fieldName,
                        @Nullable
                        Short[] values)
        Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.
        Parâmetros:
        fieldName - o campo para comparar.
        values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o campo não for um campo Curto.

      • Em

        public RealmQuery<E> in​(String fieldName,
                        @Nullable
                        Integer[] values)
        Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.
        Parâmetros:
        fieldName - o campo para comparar.
        values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o campo não for um campo inteiro.

      • Em

        public RealmQuery<E> in​(String fieldName,
                        @Nullable
                        Long[] values)
        Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.
        Parâmetros:
        fieldName - o campo para comparar.
        values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o campo não for um campo Longo. vazio.

      • Em

        public RealmQuery<E> in​(String fieldName,
                        @Nullable
                        Double[] values)
        Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.
        Parâmetros:
        fieldName - o campo para comparar.
        values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o campo não for um campo Duplo . vazio.

      • Em

        public RealmQuery<E> in​(String fieldName,
                        @Nullable
                        Float[] values)
        Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.
        Parâmetros:
        fieldName - o campo para comparar.
        values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o campo não for um campo Flutuante.

      • Em

        public RealmQuery<E> in​(String fieldName,
                        @Nullable
                        Boolean[] values)
        Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.
        Parâmetros:
        fieldName - o campo para comparar.
        values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o campo não for booleano. ou vazio.

      • Em

        public RealmQuery<E> in​(String fieldName,
                        @Nullable
                        Date[] values)
        Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.
        Parâmetros:
        fieldName - o campo para comparar.
        values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o campo não for um campo de data.

      • Em

        public RealmQuery<E> in​(String fieldName,
                        RealmAny[] values)
        Em comparação. Isso permite que você teste se os objetos correspondem a qualquer valor em uma matriz de valores.
        Parâmetros:
        fieldName - o campo para comparar.
        values - array de valores para comparar. Se null ou a array vazia for fornecida, a query nunca corresponderá a nenhum resultado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o campo não for um campo de data.

      • Não é igual a

        public RealmQuery<E> notEqualTo​(String fieldName,
                                @Nullable
                                String value)
        Comparação não igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Não é igual a

        public RealmQuery<E> notEqualTo​(String fieldName,
                                @Nullable
                                String value,
                                Case casing)
        Comparação não igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        casing - como o invólucro é tratado. Case.INSENSITIVE funciona apenas para os caracteres Latin-1.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Não é igual a

        public RealmQuery<E> notEqualTo​(String fieldName,
                                RealmAny value,
                                Case casing)
        Comparação não igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        casing - como o invólucro é tratado. Case.INSENSITIVE funciona apenas para os caracteres Latin-1.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Não é igual a

        public RealmQuery<E> notEqualTo​(String fieldName,
                                Decimal128 value)
        Comparação não igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Não é igual a

        public RealmQuery<E> notEqualTo​(String fieldName,
                                ObjectId value)
        Comparação não igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Não é igual a

        public RealmQuery<E> notEqualTo​(String fieldName,
                                UUID value)
        Comparação não igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Não é igual a

        public RealmQuery<E> notEqualTo​(String fieldName,
                                RealmAny value)
        Comparação não igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Não é igual a

        public RealmQuery<E> notEqualTo​(String fieldName,
                                @Nullable
                                Byte value)
        Comparação não igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Não é igual a

        public RealmQuery<E> notEqualTo​(String fieldName,
                                @Nullable
                                byte[] value)
        Comparação não igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Não é igual a

        public RealmQuery<E> notEqualTo​(String fieldName,
                                @Nullable
                                Short value)
        Comparação não igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Não é igual a

        public RealmQuery<E> notEqualTo​(String fieldName,
                                @Nullable
                                Integer value)
        Comparação não igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Não é igual a

        public RealmQuery<E> notEqualTo​(String fieldName,
                                @Nullable
                                Long value)
        Comparação não igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Não é igual a

        public RealmQuery<E> notEqualTo​(String fieldName,
                                @Nullable
                                Double value)
        Comparação não igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Não é igual a

        public RealmQuery<E> notEqualTo​(String fieldName,
                                @Nullable
                                Float value)
        Comparação não igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Não é igual a

        public RealmQuery<E> notEqualTo​(String fieldName,
                                @Nullable
                                Boolean value)
        Comparação não igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Não é igual a

        public RealmQuery<E> notEqualTo​(String fieldName,
                                @Nullable
                                Date value)
        Comparação não igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • maior que

        public RealmQuery<E> greaterThan​(String fieldName,
                                 int value)
        Comparação maior que.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • maior que

        public RealmQuery<E> greaterThan​(String fieldName,
                                 long value)
        Comparação maior que.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • maior que

        public RealmQuery<E> greaterThan​(String fieldName,
                                 double value)
        Comparação maior que.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • maior que

        public RealmQuery<E> greaterThan​(String fieldName,
                                 float value)
        Comparação maior que.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • maior que

        public RealmQuery<E> greaterThan​(String fieldName,
                                 Date value)
        Comparação maior que.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • maior que

        public RealmQuery<E> greaterThan​(String fieldName,
                                 RealmAny value)
        Comparação maior que.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • maior que

        public RealmQuery<E> greaterThan​(String fieldName,
                                 Decimal128 value)
        Comparação maior que.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • maior que

        public RealmQuery<E> greaterThan​(String fieldName,
                                 ObjectId value)
        Comparação maior que.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • maior que

        public RealmQuery<E> greaterThan​(String fieldName,
                                 UUID value)
        Comparação maior que.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • maiorThanOrEqualTo

        public RealmQuery<E> greaterThanOrEqualTo​(String fieldName,
                                          int value)
        Comparação maior ou igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • maiorThanOrEqualTo

        public RealmQuery<E> greaterThanOrEqualTo​(String fieldName,
                                          long value)
        Comparação maior ou igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • maiorThanOrEqualTo

        public RealmQuery<E> greaterThanOrEqualTo​(String fieldName,
                                          double value)
        Comparação maior ou igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • maiorThanOrEqualTo

        public RealmQuery<E> greaterThanOrEqualTo​(String fieldName,
                                          float value)
        Comparação maior ou igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo

      • maiorThanOrEqualTo

        public RealmQuery<E> greaterThanOrEqualTo​(String fieldName,
                                          Date value)
        Comparação maior ou igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • maiorThanOrEqualTo

        public RealmQuery<E> greaterThanOrEqualTo​(String fieldName,
                                          Decimal128 value)
        Comparação maior ou igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • maiorThanOrEqualTo

        public RealmQuery<E> greaterThanOrEqualTo​(String fieldName,
                                          ObjectId value)
        Comparação maior ou igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • maiorThanOrEqualTo

        public RealmQuery<E> greaterThanOrEqualTo​(String fieldName,
                                          UUID value)
        Comparação maior ou igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • maiorThanOrEqualTo

        public RealmQuery<E> greaterThanOrEqualTo​(String fieldName,
                                          RealmAny value)
        Comparação maior ou igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • menos de

        public RealmQuery<E> lessThan​(String fieldName,
                              int value)
        Comparação menos que.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • menos de

        public RealmQuery<E> lessThan​(String fieldName,
                              long value)
        Comparação menos que.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • menos de

        public RealmQuery<E> lessThan​(String fieldName,
                              Decimal128 value)
        Comparação menos que.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • menos de

        public RealmQuery<E> lessThan​(String fieldName,
                              ObjectId value)
        Comparação menos que.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • menos de

        public RealmQuery<E> lessThan​(String fieldName,
                              UUID value)
        Comparação menos que.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • menos de

        public RealmQuery<E> lessThan​(String fieldName,
                              double value)
        Comparação menos que.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • menos de

        public RealmQuery<E> lessThan​(String fieldName,
                              float value)
        Comparação menos que.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • menos de

        public RealmQuery<E> lessThan​(String fieldName,
                              Date value)
        Comparação menos que.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • menos de

        public RealmQuery<E> lessThan​(String fieldName,
                              RealmAny value)
        Comparação menos que.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Menor ou igual a

        public RealmQuery<E> lessThanOrEqualTo​(String fieldName,
                                       int value)
        Comparação menor ou igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Menor ou igual a

        public RealmQuery<E> lessThanOrEqualTo​(String fieldName,
                                       long value)
        Comparação menor ou igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Menor ou igual a

        public RealmQuery<E> lessThanOrEqualTo​(String fieldName,
                                       Decimal128 value)
        Comparação menor ou igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Menor ou igual a

        public RealmQuery<E> lessThanOrEqualTo​(String fieldName,
                                       ObjectId value)
        Comparação menor ou igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Menor ou igual a

        public RealmQuery<E> lessThanOrEqualTo​(String fieldName,
                                       UUID value)
        Comparação menor ou igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Menor ou igual a

        public RealmQuery<E> lessThanOrEqualTo​(String fieldName,
                                       double value)
        Comparação menor ou igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Menor ou igual a

        public RealmQuery<E> lessThanOrEqualTo​(String fieldName,
                                       float value)
        Comparação menor ou igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Menor ou igual a

        public RealmQuery<E> lessThanOrEqualTo​(String fieldName,
                                       Date value)
        Comparação menor ou igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Menor ou igual a

        public RealmQuery<E> lessThanOrEqualTo​(String fieldName,
                                       RealmAny value)
        Comparação menor ou igual a.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor com o qual comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • entre

        public RealmQuery<E> between​(String fieldName,
                             int from,
                             int to)
        Entre a condição.
        Parâmetros:
        fieldName - o campo para comparar.
        from - valor mais baixo (inclusive).
        to - valor mais alto (inclusive).
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • entre

        public RealmQuery<E> between​(String fieldName,
                             long from,
                             long to)
        Entre a condição.
        Parâmetros:
        fieldName - o campo para comparar.
        from - valor mais baixo (inclusive).
        to - valor mais alto (inclusive).
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • entre

        public RealmQuery<E> between​(String fieldName,
                             double from,
                             double to)
        Entre a condição.
        Parâmetros:
        fieldName - o campo para comparar.
        from - valor mais baixo (inclusive).
        to - valor mais alto (inclusive).
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • entre

        public RealmQuery<E> between​(String fieldName,
                             float from,
                             float to)
        Entre a condição.
        Parâmetros:
        fieldName - o campo para comparar.
        from - valor mais baixo (inclusive).
        to - valor mais alto (inclusive).
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • entre

        public RealmQuery<E> between​(String fieldName,
                             Date from,
                             Date to)
        Entre a condição.
        Parâmetros:
        fieldName - o campo para comparar.
        from - valor mais baixo (inclusive).
        to - valor mais alto (inclusive).
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • entre

        public RealmQuery<E> between​(String fieldName,
                             RealmAny from,
                             RealmAny to)
        Entre a condição.
        Parâmetros:
        fieldName - o campo para comparar.
        from - valor mais baixo (inclusive).
        to - valor mais alto (inclusive).
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • entre

        public RealmQuery<E> between​(String fieldName,
                             Decimal128 from,
                             Decimal128 to)
        Entre a condição.
        Parâmetros:
        fieldName - o campo para comparar.
        from - valor mais baixo (inclusive).
        to - valor mais alto (inclusive).
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • contém

        public RealmQuery<E> contains​(String fieldName,
                              String value)
        Condição de que o valor do campo contém a substring especificada.
        Parâmetros:
        fieldName - o campo para comparar.
        value - a substring.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • contém

        public RealmQuery<E> contains​(String fieldName,
                              RealmAny value)
        Condição de que o valor do campo contém a substring especificada.
        Parâmetros:
        fieldName - o campo para comparar.
        value - a substring.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • contém

        public RealmQuery<E> contains​(String fieldName,
                              String value,
                              Case casing)
        Condição de que o valor do campo contém a substring especificada.
        Parâmetros:
        fieldName - o campo para comparar.
        value - a substring.
        casing - como lidar com o invólucro. Definir isso como Case.INSENSITIVE só funciona com caracteres Latin-1.
        Retorna:
        O objeto de consulta.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • contém

        public RealmQuery<E> contains​(String fieldName,
                              RealmAny value,
                              Case casing)
        Condição de que o valor do campo contém a substring especificada.
        Parâmetros:
        fieldName - o campo para comparar.
        value - a substring.
        casing - como lidar com o invólucro. Definir isso como Case.INSENSITIVE só funciona com caracteres Latin-1.
        Retorna:
        O objeto de consulta.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • começa com

        public RealmQuery<E> beginsWith​(String fieldName,
                                String value)
        Condição de que o valor do campo comece com a string especificada.
        Parâmetros:
        fieldName - o campo para comparar.
        value - a cadeia de caracteres.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • começa com

        public RealmQuery<E> beginsWith​(String fieldName,
                                RealmAny value)
        Condição de que o valor do campo comece com a string especificada.
        Parâmetros:
        fieldName - o campo para comparar.
        value - a cadeia de caracteres.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • começa com

        public RealmQuery<E> beginsWith​(String fieldName,
                                String value,
                                Case casing)
        Condição para que o valor do campo comece com a substring especificada.
        Parâmetros:
        fieldName - o campo para comparar.
        value - a substring.
        casing - como lidar com o invólucro. Definir isso como Case.INSENSITIVE só funciona com caracteres Latin-1.
        Retorna:
        o objeto de query
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • começa com

        public RealmQuery<E> beginsWith​(String fieldName,
                                RealmAny value,
                                Case casing)
        Condição para que o valor do campo comece com a substring especificada.
        Parâmetros:
        fieldName - o campo para comparar.
        value - a substring.
        casing - como lidar com o invólucro. Definir isso como Case.INSENSITIVE só funciona com caracteres Latin-1.
        Retorna:
        o objeto de query
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • termina com

        public RealmQuery<E> endsWith​(String fieldName,
                              String value)
        Condição de que o valor do campo termine com a string especificada.
        Parâmetros:
        fieldName - o campo para comparar.
        value - a cadeia de caracteres.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • termina com

        public RealmQuery<E> endsWith​(String fieldName,
                              RealmAny value)
        Condição de que o valor do campo termine com a string especificada.
        Parâmetros:
        fieldName - o campo para comparar.
        value - a cadeia de caracteres.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • termina com

        public RealmQuery<E> endsWith​(String fieldName,
                              String value,
                              Case casing)
        Condição de que o valor do campo termine com a substring especificada.
        Parâmetros:
        fieldName - o campo para comparar.
        value - a substring.
        casing - como lidar com o invólucro. Definir isso como Case.INSENSITIVE só funciona com caracteres Latin-1.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • termina com

        public RealmQuery<E> endsWith​(String fieldName,
                              RealmAny value,
                              Case casing)
        Condição de que o valor do campo termine com a substring especificada.
        Parâmetros:
        fieldName - o campo para comparar.
        value - a substring.
        casing - como lidar com o invólucro. Definir isso como Case.INSENSITIVE só funciona com caracteres Latin-1.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • semelhante a

        public RealmQuery<E> like​(String fieldName,
                          String value)
        Condição de que o valor do campo corresponda à substring especificada, com curingas:
        • '*' corresponde a [0, n] caracteres unicode
        • '?' corresponde a um único caractere unicode.
        Parâmetros:
        fieldName - o campo para comparar.
        value - a sequência curinga.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • semelhante a

        public RealmQuery<E> like​(String fieldName,
                          RealmAny value)
        Condição de que o valor do campo corresponda à substring especificada, com curingas:
        • '*' corresponde a [0, n] caracteres unicode
        • '?' corresponde a um único caractere unicode.
        Parâmetros:
        fieldName - o campo para comparar.
        value - a sequência curinga.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • semelhante a

        public RealmQuery<E> like​(String fieldName,
                          String value,
                          Case casing)
        Condição de que o valor do campo corresponda à substring especificada, com curingas:
        • '*' corresponde a [0, n] caracteres unicode
        • '?' corresponde a um único caractere unicode.
        Parâmetros:
        fieldName - o campo para comparar.
        value - a sequência curinga.
        casing - como lidar com o invólucro. Definir isso como Case.INSENSITIVE só funciona com caracteres Latin-1.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • semelhante a

        public RealmQuery<E> like​(String fieldName,
                          RealmAny value,
                          Case casing)
        Condição de que o valor do campo corresponda à substring especificada, com curingas:
        • '*' corresponde a [0, n] caracteres unicode
        • '?' corresponde a um único caractere unicode.
        Parâmetros:
        fieldName - o campo para comparar.
        value - a sequência curinga.
        casing - como lidar com o invólucro. Definir isso como Case.INSENSITIVE só funciona com caracteres Latin-1.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se um ou mais argumentos não corresponderem à classe ou ao tipo de campo.

      • Comece o grupo

        public RealmQuery<E> beginGroup()
        Iniciar o agrupamento de condições ("parêntese esquerdo"). Um grupo deve ser fechado com uma chamada para endGroup().
        Retorna:
        o objeto de query.
        Veja também:
        endGroup()

      • EndGroup

        public RealmQuery<E> endGroup()
        Agrupamento final de condições ("parêntese direito") que foi aberto por uma chamada para beginGroup().
        Retorna:
        o objeto de query.
        Veja também:
        beginGroup()

      • ou

        public RealmQuery<E> or()
        Lógica-ou duas condições.
        Retorna:
        o objeto de query.

      • e a

        public RealmQuery<E> and()
        Lógica e duas condições O Realm aplica automaticamente lógica e entre todas as declarações de query, portanto, isso destina-se apenas a ser um meio de aumentar a legibilidade.
        Retorna:
        o objeto de query

      • não

        public RealmQuery<E> not()
        Negar condição.
        Retorna:
        o objeto de query.

      • isEmpty

        public RealmQuery<E> isEmpty​(String fieldName)
        Condição que encontra valores considerados "vazios", ou seja, uma lista vazia, a string de comprimento 0 ou array de bytes.
        Parâmetros:
        fieldName - o campo para comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido ou seu tipo não for uma array RealmList, String ou bytes.

      • isNotEmpty

        public RealmQuery<E> isNotEmpty​(String fieldName)
        Condição que encontra valores considerados "Não vazios", ou seja, uma lista, uma string ou uma array de bytes com valores não vazios.
        Parâmetros:
        fieldName - o campo para comparar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido ou seu tipo não for uma array RealmList, String ou bytes.

      • containsKey

        public RealmQuery<E> containsKey​(String fieldName,
                                 @Nullable
                                 String key)
        Condição de que o valor, se um campo de dicionário, contém a chave especificada.
        Parâmetros:
        fieldName - o campo para comparar.
        key - a chave para pesquisar.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido.

      • contémValor

        public RealmQuery<E> containsValue​(String fieldName,
                                   @Nullable
                                   Boolean value)
        Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor a ser pesquisado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido.

      • contémValor

        public RealmQuery<E> containsValue​(String fieldName,
                                   @Nullable
                                   Byte value)
        Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor a ser pesquisado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido.

      • contémValor

        public RealmQuery<E> containsValue​(String fieldName,
                                   @Nullable
                                   Short value)
        Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor a ser pesquisado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido.

      • contémValor

        public RealmQuery<E> containsValue​(String fieldName,
                                   @Nullable
                                   Integer value)
        Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor a ser pesquisado
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido.

      • contémValor

        public RealmQuery<E> containsValue​(String fieldName,
                                   @Nullable
                                   Long value)
        Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor a ser pesquisado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido.

      • contémValor

        public RealmQuery<E> containsValue​(String fieldName,
                                   @Nullable
                                   Double value)
        Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor a ser pesquisado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido.

      • contémValor

        public RealmQuery<E> containsValue​(String fieldName,
                                   @Nullable
                                   Float value)
        Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor a ser pesquisado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido.

      • contémValor

        public RealmQuery<E> containsValue​(String fieldName,
                                   @Nullable
                                   String value)
        Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor a ser pesquisado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido.

      • contémValor

        public RealmQuery<E> containsValue​(String fieldName,
                                   @Nullable
                                   byte[] value)
        Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor a ser pesquisado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido.

      • contémValor

        public RealmQuery<E> containsValue​(String fieldName,
                                   @Nullable
                                   Date value)
        Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor a ser pesquisado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido.

      • contémValor

        public RealmQuery<E> containsValue​(String fieldName,
                                   @Nullable
                                   Decimal128 value)
        Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor a ser pesquisado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido.

      • contémValor

        public RealmQuery<E> containsValue​(String fieldName,
                                   @Nullable
                                   ObjectId value)
        Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor a ser pesquisado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido.

      • contémValor

        public RealmQuery<E> containsValue​(String fieldName,
                                   @Nullable
                                   UUID value)
        Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor a ser pesquisado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido.

      • contémValor

        public RealmQuery<E> containsValue​(String fieldName,
                                   RealmAny value)
        Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor a ser pesquisado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido.

      • contémValor

        public RealmQuery<E> containsValue​(String fieldName,
                                   RealmModel value)
        Condição que esse valor, se for um campo de dicionário, contenha o valor especificado.
        Parâmetros:
        fieldName - o campo para comparar.
        value - o valor a ser pesquisado.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido.

      • contémEntry

        public RealmQuery<E> containsEntry​(String fieldName,
                                   Map.Entry<String,​?> entry)
        Condição de que o valor, se um campo de dicionário, contiver a entrada especificada.
        Parâmetros:
        fieldName - o campo para comparar.
        entry - a entrada a ser pesquisada.
        Retorna:
        o objeto de query.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não for válido.

      • soma

        soma de número público (string fieldName )
        Calcula a soma de um determinado campo.
        Parâmetros:
        fieldName - o campo a ser somado. Somente os campos numéricos e RealmAny são suportados.
        Retorna:
        a soma dos campos dos objetos correspondentes. Se não existirem objetos ou todos eles tiverem null como o valor para o campo fornecido, 0 será retornado. Ao calcular a soma, objetos com valores null são ignorados. Quando aplicado a um campo RealmAny, somente os valores numéricos serão somados (Byte/Integer/Integer/Long/Float/Double/Decimal128) e o tipo de retorno será Decimal128.
        Lançamentos:
        IllegalArgumentException - se o campo não for um tipo de número.
        RealmException - se chamado do thread da UI após optar por não atuar por meio RealmConfiguration.Builder.allowQueriesOnUiThread(boolean).

      • média

        média dupla pública (String fieldName)
        Retorna a média de um determinado campo. Não suporta notação de campo pontilhado.
        Parâmetros:
        fieldName - o campo para calcular a média. Somente campos numéricos são permitidos.
        Retorna:
        a média do campo fornecido entre os objetos nos resultados da query. Isso será do tipo double para todos os tipos de campos numéricos. Se não existirem objetos ou todos eles tiverem null como o valor para o campo fornecido, 0 será retornado. Ao calcular a média, objetos com valores null são ignorados.
        Lançamentos:
        IllegalArgumentException - se o campo não for um tipo de número.
        RealmException - se chamado do thread da UI após optar por não atuar por meio RealmConfiguration.Builder.allowQueriesOnUiThread(boolean).

      • médiaDecimal128

        @Nullable
public Decimal128 médiaDecimal128 (String fieldName)
        Retorna a média de um determinado campo. Não suporta notação de campo pontilhado.
        Parâmetros:
        fieldName - o campo para calcular a média. Somente campos Decimal128 são suportados. Para outros tipos de números, considere usar average(String).
        Retorna:
        a média do campo fornecido entre os objetos nos resultados da query. Este será do tipo Decimal128. Se não existirem objetos ou se todos tiverem null , o valor do campo fornecido 0 será retornado. Ao calcular a média, objetos com valores null são ignorados.
        Lançamentos:
        IllegalArgumentException - se o campo não for do tipo Decimal128.
        RealmException - se chamado do thread da UI após optar por não atuar por meio RealmConfiguration.Builder.allowQueriesOnUiThread(boolean).

      • médiaRealmAny

        @Nullable
public Decimal128 médiaRealmAny (String fieldName)
        Retorna a média de um determinado campo. Não suporta notação de campo pontilhado.
        Parâmetros:
        fieldName - o campo para calcular a média. Somente os campos RealmAny são suportados. Para outros tipos, considere usar average(String).
        Retorna:
        a média do campo fornecido entre os objetos nos resultados da query. Este será do tipo Decimal128. Se não existirem objetos ou se todos tiverem null , o valor do campo fornecido 0 será retornado. Ao calcular a média, objetos com valores null são ignorados.
        Lançamentos:
        IllegalArgumentException - se o campo não for do tipo RealmAny.
        RealmException - se chamado do thread da UI após optar por não atuar por meio RealmConfiguration.Builder.allowQueriesOnUiThread(boolean).

      • min

        @Nullable
public Number min(String fieldName)
        Localiza o valor mínimo de um campo.
        Parâmetros:
        fieldName - o campo para procurar um mínimo. Somente campos numéricos são permitidos.
        Retorna:
        se não existirem objetos ou se todos eles tiverem null como o valor para o campo fornecido, null será retornado. Caso contrário, o valor mínimo é devolvido. Ao determinar o valor mínimo, os objetos com valores null são ignorados.
        Lançamentos:
        IllegalArgumentException - se o campo não for um tipo de número.
        RealmException - se chamado do thread da UI após optar por não atuar por meio RealmConfiguration.Builder.allowQueriesOnUiThread(boolean).

      • minimumDate

        @Nullable
public Date minimumDate(String fieldName)
        Localiza o valor mínimo de um campo.
        Parâmetros:
        fieldName - o nome do campo
        Retorna:
        se não existirem objetos ou se todos eles tiverem null como valor para o campo de data fornecido, null será retornado. Caso contrário, a data mínima é retornada. Ao determinar a data mínima, os objetos com valores null são ignorados.
        Lançamentos:
        UnsupportedOperationException - se a query não for válida ("erro de sintaxe").
        RealmException - se chamado do thread da UI após optar por não atuar por meio RealmConfiguration.Builder.allowQueriesOnUiThread(boolean).

      • minRealmAny

        public RealmAny minRealmAny(String fieldName)
        Localiza o valor mínimo de um campo RealmAny .
        Parâmetros:
        fieldName - o campo que contém um valor RealmAny.
        Retorna:
        se não existirem objetos ou se todos eles tiverem null como o valor do campo RealmAny fornecido, RealmAny.Type.NULL será retornado. Caso contrário, o mínimo de RealmAny é retornado. Ao determinar o RealmAny mínimo, os objetos com valores null são ignorados. Consulte a documentação do RealmAny para obter mais detalhes sobre como os valores de RealmAny são comparados.
        Lançamentos:
        UnsupportedOperationException - se a query não for válida ("erro de sintaxe").
        RealmException - se chamado do thread da UI após optar por não atuar por meio RealmConfiguration.Builder.allowQueriesOnUiThread(boolean).

      • max

        @Nullable
public Number max(String fieldName)
        Localiza o valor máximo de um campo.
        Parâmetros:
        fieldName - o campo para procurar um máximo. Somente campos numéricos são permitidos.
        Retorna:
        se não existirem objetos ou se todos eles tiverem null como o valor para o campo fornecido, null será retornado. Caso contrário, o valor máximo é retornado. Ao determinar o valor máximo, os objetos com valores null são ignorados.
        Lançamentos:
        IllegalArgumentException - se o campo não for um tipo de número.
        RealmException - se chamado do thread da UI após optar por não atuar por meio RealmConfiguration.Builder.allowQueriesOnUiThread(boolean).

      • maximumDate

        @Nullable
public Date maximumDate(String fieldName)
        Localiza o valor máximo de um campo.
        Parâmetros:
        fieldName - o nome do campo.
        Retorna:
        se não existirem objetos ou se todos eles tiverem null como valor para o campo de data fornecido, null será retornado. Caso contrário, a data máxima é retornada. Ao determinar a data máxima, os objetos com valores null são ignorados.
        Lançamentos:
        UnsupportedOperationException - se a query não for válida ("erro de sintaxe").

      • maxRealmAny

        public RealmAny maxRealmAny(String fieldName)
        Localiza o valor máximo de um campo RealmAny .
        Parâmetros:
        fieldName - o campo que contém um valor RealmAny.
        Retorna:
        se não existirem objetos ou se todos eles tiverem null como o valor do campo RealmAny fornecido, RealmAny.Type.NULL será retornado. Caso contrário, o RealmAny máximo será retornado. Ao determinar o RealmAny máximo, os objetos com valores null são ignorados. Consulte a documentação do RealmAny para obter mais detalhes sobre como os valores de RealmAny são comparados.
        Lançamentos:
        UnsupportedOperationException - se a query não for válida ("erro de sintaxe").

      • sort

        public RealmQuery<E> sort​(String fieldName)
        Classifica o resultado da query pelo nome de campo específico em ordem crescente.

        No momento, a classificação está limitada aos conjuntos de caracteres em 'Latin Basic', 'Latin Supplement', 'Latin Extended A', 'Latin Extended B' (UTF-8 faixa 0-591). Para outros conjuntos de caracteres, a classificação não terá efeito.

        Parâmetros:
        fieldName - o nome do campo pelo qual classificar.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não existir.
        IllegalStateException - se uma ordem de classificação já tiver sido definida.

      • sort

        public RealmQuery<E> sort​(String fieldName,
                          Sort sortOrder)
        Classifica o resultado da query pelo nome e ordem do campo especificado.

        No momento, a classificação está limitada aos conjuntos de caracteres em 'Latin Basic', 'Latin Supplement', 'Latin Extended A', 'Latin Extended B' (UTF-8 faixa 0-591). Para outros conjuntos de caracteres, a classificação não terá efeito.

        Parâmetros:
        fieldName - o nome do campo pelo qual classificar.
        sortOrder - como classificar os resultados.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não existir.
        IllegalStateException - se uma ordem de classificação já tiver sido definida.

      • sort

        public RealmQuery<E> sort​(String fieldName1,
                          Sort sortOrder1,
                          String fieldName2,
                          Sort sortOrder2)
        Classifica o resultado da query pelos nomes de campo específicos nas ordens fornecidas. fieldName2 só é usado no caso de valores iguais em fieldName1.

        No momento, a classificação está limitada aos conjuntos de caracteres em 'Latin Basic', 'Latin Supplement', 'Latin Extended A', 'Latin Extended B' (UTF-8 faixa 0-591). Para outros conjuntos de caracteres, a classificação não terá efeito.

        Parâmetros:
        fieldName1 - nome do primeiro campo
        sortOrder1 - ordem de classificação para o primeiro campo
        fieldName2 - nome do segundo campo
        sortOrder2 - ordem de classificação para o segundo campo
        Lançamentos:
        IllegalArgumentException - se o nome do campo não existir.
        IllegalStateException - se uma ordem de classificação já tiver sido definida.

      • sort

        public RealmQuery<E> sort​(String[] fieldNames,
                          Sort[] sortOrders)
        Classifica o resultado da query pelos nomes de campo específicos nas ordens fornecidas. Os campos posteriores só serão utilizados se os valores de campo anteriores forem iguais.

        No momento, a classificação está limitada aos conjuntos de caracteres em 'Latin Basic', 'Latin Supplement', 'Latin Extended A', 'Latin Extended B' (UTF-8 faixa 0-591). Para outros conjuntos de caracteres, a classificação não terá efeito.

        Parâmetros:
        fieldNames - uma array de nomes de campos para classificar.
        sortOrders - como classificar os nomes dos campos.
        Lançamentos:
        IllegalArgumentException - se o nome do campo não existir.
        IllegalStateException - se uma ordem de classificação já tiver sido definida.

      • distinto

        public RealmQuery<E> distinct​(String firstFieldName,
                              String... remainingFieldNames)
        Seleciona um conjunto distinto de objetos de uma classe específica. Quando vários campos distintos são fornecidos, todas as combinações exclusivas de valores nos campos serão retornadas. No caso de várias correspondências, é indefinido qual objeto será retornado. A menos que o resultado seja classificado, o primeiro objeto será retornado.
        Parâmetros:
        firstFieldName - o primeiro nome do campo a ser usado ao encontrar objetos distintos.
        remainingFieldNames - nomes de campos restantes ao determinar todas as combinações únicas de valores de campo.
        Lançamentos:
        IllegalArgumentException - se os nomes dos campos estiverem vazios ou null, não existir, for um tipo não suportado ou ponto para um campo vinculado.
        IllegalStateException - se nomes de campos distintos já estiverem definidos.

      • limit

        public RealmQuery<E> limit​(long limit)
        Limita o número de objetos retornados caso a query corresponda a mais objetos.

        Observe que, ao usar este método em combinação com sort(String) e distinct(String, String...) , eles serão executados na ordem em que foram adicionados, o que pode afetar o resultado final.

        Parâmetros:
        limit - um limite que é &ge; 1.
        Lançamentos:
        IllegalArgumentException - se o limit fornecido for menor que 1.

      • sempre verdadeiro

        public RealmQuery<E> alwaysTrue()
        Este predicado sempre corresponderá.

      • sempre falso

        public RealmQuery<E> alwaysFalse()
        Este predicado nunca corresponderá, resultando na consulta sempre retornando 0 resultados.

      • Predicado bruto

        public RealmQuery<E> rawPredicate​(String predicate,
                                  Object... arguments)
        Crie um predicado baseado em texto utilizando a Realm Query Language. Este predicado pode ser combinado com outros predicados brutos ou de tipo seguro, ele aceita Realm value como argumentos.

        Os nomes de classes e propriedades usados no predicado bruto podem ser os nomes definidos nas classes do modelo Realm ou os nomes internos definidos usando as anotações RealmClass ou RealmField . Se uma classe ou nome de propriedade contiver espaços, estes deverão ser evitados.

        Os argumentos são definidos no predicado de string como $argument_index, onde $argument_index é um número inteiro decimal que especifica a posição do argumento na lista de argumentos. O primeiro argumento é referenciado por $0, o segundo por $1, etc.

        Consulte estes Docs para obter uma descrição mais detalhada da RealmQL. 

         Exemplos:
 
 RealmQuery<Person> query = realm.where(Person.class);

 // Simple query
 query.rawPredicate("name = 'Jane'");

 // Spaces in property name
 query.rawPredicate("my\ property = 'Jane'");

 // Multiple predicates
 query.rawPredicate("name = 'Jane' OR name = 'John'")

 // Collection queries
 query.rawPredicate("children.@count > 3")
 query.rawPredicate("ALL children.age > 18")

 // Sub queries
 query.rawPredicate("SUBQUERY(children, $child, $child.age > 21 AND $child.gender = 'male').@count > 0");

 // Sort, Distinct, Limit
 query.rawPredicate("name = 'Jane' SORT(lastName ASC) DISTINCT(city) LIMIT(5)");

 // Arguments
 query.rawPredicate("name = $0 AND age > $1", "Jane", 18);
        Parâmetros:
        predicate - um predicado da Realm Query Language.
        arguments - Realm value para o predicado.
        Lançamentos:
        IllegalArgumentException - se houver um erro de sintaxe.

      • getRealm

        public Realm getRealm()
        Retorna a instância do Realm à qual esta query pertence.

        Chamar Closeable.close() na instância retornada não é recomendado, pois é o mesmo que chamá-la na Instância de Realm, o que pode fazer com que o Realm feche completamente, invalidando a query.

        Retorna:
        Realm instância à qual esta query pertence.
        Lançamentos:
        IllegalStateException - se o Realm for uma instância de DynamicRealm ou se o Realm já estiver fechado.

      • Obter descrição

        string pública getDescription()
        Retorna uma descrição textual desta query.
        Retorna:
        a descrição textual da query.

      • getTypeQuered

        string pública getTypeQuered()
        Retorna o nome do Realm interno do tipo que está sendo query.
        Retorna:
        o nome interno da classe de modelo Realm que está sendo query.

      • getQueryPointer

        público longo getQueryPointer()
        Retorna o ponteiro para a query subjacente do C++. Esse método só é público devido às opções de design arquitetural que são difíceis de contornar e devem ser consideradas internas e podem mudar sem aviso.
        Retorna:
        o ponteiro para a query C++ subjacente.

      • findFirstAsync

        public E findFirstAsync()
        Semelhante a findFirst() , mas executado de forma assíncrona em uma thread de trabalho. Um ouvinte deve estar registrado no RealmObject retornado para receber a notificação quando a query for concluída. O ouvinte registrado também será acionado se houver alterações feitas na query RealmObject. Se o RealmObject for excluído, o ouvinte será chamado uma última vez e depois parará. A query não será executada novamente.
        Retorna:
        imediatamente um RealmObject vazio com isLoaded() == false. Tentar acessar qualquer campo no objeto retornado antes de ele ser carregado gerará um IllegalStateException.
        Lançamentos:
        IllegalStateException - se isso for chamado em uma thread não loop de eventos.