パッケージ io.realm

クラス RealmQuery<E>

  • 型パラメータ:
    E - クエリされるオブジェクトのクラス。

    public class RealmQuery<E>
    extends Object
    RealmQuery は、Builder パターンを使用して、 RealmまたはRealmResultsに対するクエリをカプセル化します。 クエリはfindAll()またはfindFirst()のいずれかを使用して実行されます。

    多くのクエリ関数への入力は、string としてフィールド名を受け取ります。 これは型セーフではないことに注意してください。 RealmObject クラスがリファクタリングされている場合は、クエリを中断しないように注意する必要があります。

    Realmは順序付けられていません。つまり、Realm をクエリしても、挿入された順序でオブジェクトが返される保証はありません。 特定の順序が必要な場合は、 sort(String) ( string )} や同様のメソッドを使用します。

    RealmQuery は異なるスレッド間で渡すことはできません。

    結果はほとんどの場合、迅速に取得されます。 ただし、UI スレッドから重いクエリを起動すると、フレームワークや ARN もドロップされる可能性があります。 このような動作を防ぐには、 を明示的に設定するRealmConfigurationRealmConfiguration.Builder.allowQueriesOnUiThread(boolean) を使用して Realmfalse をインスタンス化します。こうすると、クエリは非 UI スレッドから強制的に起動されるようになります。 あるいは、 findAllAsync()またはfindFirstAsync()を使用することもできます。

    以下も参照してください。
    ビルダ パターンRealm.where(Class)RealmResults.where()
    • メソッドの詳細

      • isValid

        公開ブール値 isValid()
        RealmQueryがまだ使用可能かどうか、つまり、 Realmインスタンスが閉じられておらず、親のRealmResultsが引き続き有効であるかどうかを確認します。
        次の値を返します。
        true 引き続き使用が有効な場合は、 false 、それ以外の場合は 。
      • isNull

        public RealmQuery<E> isNull​(String fieldName)
        フィールドがnullであるかどうかをテストします。 null 可能なフィールドでのみ機能します。

        リンク クエリでは、リンクパスの任意の部分がnullの場合、パス全体がnullと見なされ、たとえば、 linkFieldまたはlinkField.stringFieldのいずれかがnullの場合、 isNull("linkField.stringField")nullと見なされます。 .

        パラメーター:
        fieldName - フィールド名。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールドが null でない場合。
        以下も参照してください。
        for further infomation.
      • isNotNull

        public RealmQuery<E> isNotNull​(String fieldName)
        フィールドがnullでないかどうかをテストします。 null 可能なフィールドでのみ機能します。
        パラメーター:
        fieldName - フィールド名。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールドが null でない場合。
        以下も参照してください。
        for further infomation.
      • equalTo

        public RealmQuery<E> equalTo​(String fieldName,
                                     @Nullable
                                     String value)
        と等価比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • equalTo

        public RealmQuery<E> equalTo​(String fieldName,
                                     @Nullable
                                     String value,
                                     Case casing)
        と等価比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        casing - 大文字と小文字の処理方法。 これをCase.INSENSITIVEに設定すると、ラテン 1 文字に対してのみ機能します。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • equalTo

        public RealmQuery<E> equalTo​(String fieldName,
                                     RealmAny value,
                                     Case casing)
        と等価比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        casing - 大文字と小文字の処理方法。 これをCase.INSENSITIVEに設定すると、ラテン 1 文字に対してのみ機能します。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • equalTo

        public RealmQuery<E> equalTo​(String fieldName,
                                     @Nullable
                                     Decimal128 value)
        と等価比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • equalTo

        public RealmQuery<E> equalTo​(String fieldName,
                                     @Nullable
                                     ObjectId value)
        と等価比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • equalTo

        public RealmQuery<E> equalTo​(String fieldName,
                                     @Nullable
                                     UUID value)
        と等価比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • equalTo

        public RealmQuery<E> equalTo​(String fieldName,
                                     @Nullable
                                     Byte value)
        と等価比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • equalTo

        public RealmQuery<E> equalTo​(String fieldName,
                                     @Nullable
                                     byte[] value)
        と等価比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • equalTo

        public RealmQuery<E> equalTo​(String fieldName,
                                     @Nullable
                                     Short value)
        と等価比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • equalTo

        public RealmQuery<E> equalTo​(String fieldName,
                                     @Nullable
                                     Integer value)
        と等価比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • equalTo

        public RealmQuery<E> equalTo​(String fieldName,
                                     @Nullable
                                     Long value)
        と等価比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • equalTo

        public RealmQuery<E> equalTo​(String fieldName,
                                     @Nullable
                                     Double value)
        と等価比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • equalTo

        public RealmQuery<E> equalTo​(String fieldName,
                                     @Nullable
                                     Float value)
        と等価比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • equalTo

        public RealmQuery<E> equalTo​(String fieldName,
                                     @Nullable
                                     Boolean value)
        と等価比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • equalTo

        public RealmQuery<E> equalTo​(String fieldName,
                                     @Nullable
                                     Date value)
        と等価比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • equalTo

        public RealmQuery<E> equalTo​(String fieldName,
                                     RealmAny value)
        と等価比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • in

        public RealmQuery<E> in​(String fieldName,
                                @Nullable
                                String[] values)
        比較して。 これにより、オブジェクトが値の配列内のいずれかの値と一致するかどうかをテストできます。
        パラメーター:
        fieldName - 比較するフィールド。
        values - 比較する値の配列。 nullまたは空の配列が指定された場合、クエリは結果と一致しません。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールドがstringフィールドでない場合。
      • in

        public RealmQuery<E> in​(String fieldName,
                                @Nullable
                                String[] values,
                                Case casing)
        比較して。 これにより、オブジェクトが値の配列内のいずれかの値と一致するかどうかをテストできます。
        パラメーター:
        fieldName - 比較するフィールド。
        values - 比較する値の配列。 nullまたは空の配列が指定された場合、クエリは結果と一致しません。
        casing - 大文字と小文字の処理方法。 Case.INSENSITIVEは、ラテン 1 文字でのみ機能します。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールドがstringフィールドでない場合。
      • in

        public RealmQuery<E> in​(String fieldName,
                                @Nullable
                                Byte[] values)
        比較して。 これにより、オブジェクトが値の配列内のいずれかの値と一致するかどうかをテストできます。
        パラメーター:
        fieldName - 比較するフィールド。
        values - 比較する値の配列。 nullまたは空の配列が指定された場合、クエリは結果と一致しません。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールドが バイト フィールドでない場合。
      • in

        public RealmQuery<E> in​(String fieldName,
                                @Nullable
                                Short[] values)
        比較して。 これにより、オブジェクトが値の配列内のいずれかの値と一致するかどうかをテストできます。
        パラメーター:
        fieldName - 比較するフィールド。
        values - 比較する値の配列。 nullまたは空の配列が指定された場合、クエリは結果と一致しません。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールドが 短い フィールドでない場合。
      • in

        public RealmQuery<E> in​(String fieldName,
                                @Nullable
                                Integer[] values)
        比較して。 これにより、オブジェクトが値の配列内のいずれかの値と一致するかどうかをテストできます。
        パラメーター:
        fieldName - 比較するフィールド。
        values - 比較する値の配列。 nullまたは空の配列が指定された場合、クエリは結果と一致しません。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールドが整数フィールドでない場合。
      • in

        public RealmQuery<E> in​(String fieldName,
                                @Nullable
                                Long[] values)
        比較して。 これにより、オブジェクトが値の配列内のいずれかの値と一致するかどうかをテストできます。
        パラメーター:
        fieldName - 比較するフィールド。
        values - 比較する値の配列。 nullまたは空の配列が指定された場合、クエリは結果と一致しません。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールドが Long フィールドでない場合。 空。
      • in

        public RealmQuery<E> in​(String fieldName,
                                @Nullable
                                Double[] values)
        比較して。 これにより、オブジェクトが値の配列内のいずれかの値と一致するかどうかをテストできます。
        パラメーター:
        fieldName - 比較するフィールド。
        values - 比較する値の配列。 nullまたは空の配列が指定された場合、クエリは結果と一致しません。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールドがdoubleフィールドでない場合。 空。
      • in

        public RealmQuery<E> in​(String fieldName,
                                @Nullable
                                Float[] values)
        比較して。 これにより、オブジェクトが値の配列内のいずれかの値と一致するかどうかをテストできます。
        パラメーター:
        fieldName - 比較するフィールド。
        values - 比較する値の配列。 nullまたは空の配列が指定された場合、クエリは結果と一致しません。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールドが浮動小数フィールドでない場合。
      • in

        public RealmQuery<E> in​(String fieldName,
                                @Nullable
                                Boolean[] values)
        比較して。 これにより、オブジェクトが値の配列内のいずれかの値と一致するかどうかをテストできます。
        パラメーター:
        fieldName - 比較するフィールド。
        values - 比較する値の配列。 nullまたは空の配列が指定された場合、クエリは結果と一致しません。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールドがブール値でない場合。 または 空
      • in

        public RealmQuery<E> in​(String fieldName,
                                @Nullable
                                Date[] values)
        比較して。 これにより、オブジェクトが値の配列内のいずれかの値と一致するかどうかをテストできます。
        パラメーター:
        fieldName - 比較するフィールド。
        values - 比較する値の配列。 nullまたは空の配列が指定された場合、クエリは結果と一致しません。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールドが Date フィールドでない場合。
      • in

        public RealmQuery<E> in​(String fieldName,
                                RealmAny[] values)
        比較して。 これにより、オブジェクトが値の配列内のいずれかの値と一致するかどうかをテストできます。
        パラメーター:
        fieldName - 比較するフィールド。
        values - 比較する値の配列。 nullまたは空の配列が指定された場合、クエリは結果と一致しません。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールドが Date フィールドでない場合。
      • notEqualTo

        public RealmQuery<E> notEqualTo​(String fieldName,
                                        @Nullable
                                        String value)
        等しくない比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • notEqualTo

        public RealmQuery<E> notEqualTo​(String fieldName,
                                        @Nullable
                                        String value,
                                        Case casing)
        等しくない比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        casing - 大文字と小文字の処理方法。 Case.INSENSITIVEは、ラテン 1 文字でのみ機能します。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • notEqualTo

        public RealmQuery<E> notEqualTo​(String fieldName,
                                        RealmAny value,
                                        Case casing)
        等しくない比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        casing - 大文字と小文字の処理方法。 Case.INSENSITIVEは、ラテン 1 文字でのみ機能します。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • notEqualTo

        public RealmQuery<E> notEqualTo​(String fieldName,
                                        Decimal128 value)
        等しくない比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • notEqualTo

        public RealmQuery<E> notEqualTo​(String fieldName,
                                        ObjectId value)
        等しくない比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • notEqualTo

        public RealmQuery<E> notEqualTo​(String fieldName,
                                        UUID value)
        等しくない比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • notEqualTo

        public RealmQuery<E> notEqualTo​(String fieldName,
                                        RealmAny value)
        等しくない比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • notEqualTo

        public RealmQuery<E> notEqualTo​(String fieldName,
                                        @Nullable
                                        Byte value)
        等しくない比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • notEqualTo

        public RealmQuery<E> notEqualTo​(String fieldName,
                                        @Nullable
                                        byte[] value)
        等しくない比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • notEqualTo

        public RealmQuery<E> notEqualTo​(String fieldName,
                                        @Nullable
                                        Short value)
        等しくない比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • notEqualTo

        public RealmQuery<E> notEqualTo​(String fieldName,
                                        @Nullable
                                        Integer value)
        等しくない比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • notEqualTo

        public RealmQuery<E> notEqualTo​(String fieldName,
                                        @Nullable
                                        Long value)
        等しくない比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • notEqualTo

        public RealmQuery<E> notEqualTo​(String fieldName,
                                        @Nullable
                                        Double value)
        等しくない比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • notEqualTo

        public RealmQuery<E> notEqualTo​(String fieldName,
                                        @Nullable
                                        Float value)
        等しくない比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • notEqualTo

        public RealmQuery<E> notEqualTo​(String fieldName,
                                        @Nullable
                                        Boolean value)
        等しくない比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • notEqualTo

        public RealmQuery<E> notEqualTo​(String fieldName,
                                        @Nullable
                                        Date value)
        等しくない比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • "greaterThan"

        public RealmQuery<E> greaterThan​(String fieldName,
                                         int value)
        大なり比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • "greaterThan"

        public RealmQuery<E> greaterThan​(String fieldName,
                                         long value)
        大なり比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • "greaterThan"

        public RealmQuery<E> greaterThan​(String fieldName,
                                         double value)
        大なり比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • "greaterThan"

        public RealmQuery<E> greaterThan​(String fieldName,
                                         float value)
        大なり比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • "greaterThan"

        public RealmQuery<E> greaterThan​(String fieldName,
                                         Date value)
        大なり比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • "greaterThan"

        public RealmQuery<E> greaterThan​(String fieldName,
                                         RealmAny value)
        大なり比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • "greaterThan"

        public RealmQuery<E> greaterThan​(String fieldName,
                                         Decimal128 value)
        大なり比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • "greaterThan"

        public RealmQuery<E> greaterThan​(String fieldName,
                                         ObjectId value)
        大なり比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • "greaterThan"

        public RealmQuery<E> greaterThan​(String fieldName,
                                         UUID value)
        大なり比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • "greaterThanOrEqualTo"

        public RealmQuery<E> greaterThanOrEqualTo​(String fieldName,
                                                  int value)
        大なりまたは等しいが との比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • "greaterThanOrEqualTo"

        public RealmQuery<E> greaterThanOrEqualTo​(String fieldName,
                                                  long value)
        大なりまたは等しいが との比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • "greaterThanOrEqualTo"

        public RealmQuery<E> greaterThanOrEqualTo​(String fieldName,
                                                  double value)
        大なりまたは等しいが との比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • "greaterThanOrEqualTo"

        public RealmQuery<E> greaterThanOrEqualTo​(String fieldName,
                                                  float value)
        大なりまたは等しいが との比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合
      • "greaterThanOrEqualTo"

        public RealmQuery<E> greaterThanOrEqualTo​(String fieldName,
                                                  Date value)
        大なりまたは等しいが との比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • "greaterThanOrEqualTo"

        public RealmQuery<E> greaterThanOrEqualTo​(String fieldName,
                                                  Decimal128 value)
        大なりまたは等しいが との比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • "greaterThanOrEqualTo"

        public RealmQuery<E> greaterThanOrEqualTo​(String fieldName,
                                                  ObjectId value)
        大なりまたは等しいが との比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • "greaterThanOrEqualTo"

        public RealmQuery<E> greaterThanOrEqualTo​(String fieldName,
                                                  UUID value)
        大なりまたは等しいが との比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • "greaterThanOrEqualTo"

        public RealmQuery<E> greaterThanOrEqualTo​(String fieldName,
                                                  RealmAny value)
        大なりまたは等しいが との比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • 未満

        public RealmQuery<E> lessThan​(String fieldName,
                                      int value)
        小なり比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • 未満

        public RealmQuery<E> lessThan​(String fieldName,
                                      long value)
        小なり比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • 未満

        public RealmQuery<E> lessThan​(String fieldName,
                                      Decimal128 value)
        小なり比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • 未満

        public RealmQuery<E> lessThan​(String fieldName,
                                      ObjectId value)
        小なり比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • 未満

        public RealmQuery<E> lessThan​(String fieldName,
                                      UUID value)
        小なり比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • 未満

        public RealmQuery<E> lessThan​(String fieldName,
                                      double value)
        小なり比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • 未満

        public RealmQuery<E> lessThan​(String fieldName,
                                      float value)
        小なり比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • 未満

        public RealmQuery<E> lessThan​(String fieldName,
                                      Date value)
        小なり比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • 未満

        public RealmQuery<E> lessThan​(String fieldName,
                                      RealmAny value)
        小なり比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • lessThanOrEqualTo

        public RealmQuery<E> lessThanOrEqualTo​(String fieldName,
                                               int value)
        小なりと等価の比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • lessThanOrEqualTo

        public RealmQuery<E> lessThanOrEqualTo​(String fieldName,
                                               long value)
        小なりと等価の比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • lessThanOrEqualTo

        public RealmQuery<E> lessThanOrEqualTo​(String fieldName,
                                               Decimal128 value)
        小なりと等価の比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • lessThanOrEqualTo

        public RealmQuery<E> lessThanOrEqualTo​(String fieldName,
                                               ObjectId value)
        小なりと等価の比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • lessThanOrEqualTo

        public RealmQuery<E> lessThanOrEqualTo​(String fieldName,
                                               UUID value)
        小なりと等価の比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • lessThanOrEqualTo

        public RealmQuery<E> lessThanOrEqualTo​(String fieldName,
                                               double value)
        小なりと等価の比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • lessThanOrEqualTo

        public RealmQuery<E> lessThanOrEqualTo​(String fieldName,
                                               float value)
        小なりと等価の比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • lessThanOrEqualTo

        public RealmQuery<E> lessThanOrEqualTo​(String fieldName,
                                               Date value)
        小なりと等価の比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • lessThanOrEqualTo

        public RealmQuery<E> lessThanOrEqualTo​(String fieldName,
                                               RealmAny value)
        小なりと等価の比較。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 比較する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • public RealmQuery<E> between​(String fieldName,
                                     int from,
                                     int to)
        条件中。
        パラメーター:
        fieldName - 比較するフィールド。
        from - の最小値(この値を含む)。
        to - の最高値(この値を含む)。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • public RealmQuery<E> between​(String fieldName,
                                     long from,
                                     long to)
        条件中。
        パラメーター:
        fieldName - 比較するフィールド。
        from - の最小値(この値を含む)。
        to - の最高値(この値を含む)。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • public RealmQuery<E> between​(String fieldName,
                                     double from,
                                     double to)
        条件中。
        パラメーター:
        fieldName - 比較するフィールド。
        from - の最小値(この値を含む)。
        to - の最高値(この値を含む)。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • public RealmQuery<E> between​(String fieldName,
                                     float from,
                                     float to)
        条件中。
        パラメーター:
        fieldName - 比較するフィールド。
        from - の最小値(この値を含む)。
        to - の最高値(この値を含む)。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • public RealmQuery<E> between​(String fieldName,
                                     Date from,
                                     Date to)
        条件中。
        パラメーター:
        fieldName - 比較するフィールド。
        from - の最小値(この値を含む)。
        to - の最高値(この値を含む)。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • public RealmQuery<E> between​(String fieldName,
                                     RealmAny from,
                                     RealmAny to)
        条件中。
        パラメーター:
        fieldName - 比較するフィールド。
        from - の最小値(この値を含む)。
        to - の最高値(この値を含む)。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • public RealmQuery<E> between​(String fieldName,
                                     Decimal128 from,
                                     Decimal128 to)
        条件中。
        パラメーター:
        fieldName - 比較するフィールド。
        from - の最小値(この値を含む)。
        to - の最高値(この値を含む)。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • に含まれる

        public RealmQuery<E> contains​(String fieldName,
                                      String value)
        フィールドの値に指定された部分文字列が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 部分文字列。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • に含まれる

        public RealmQuery<E> contains​(String fieldName,
                                      RealmAny value)
        フィールドの値に指定された部分文字列が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 部分文字列。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • に含まれる

        public RealmQuery<E> contains​(String fieldName,
                                      String value,
                                      Case casing)
        フィールドの値に指定された部分文字列が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 部分文字列。
        casing - 大文字と小文字の処理方法。 これをCase.INSENSITIVEに設定すると、ラテン 1 文字に対してのみ機能します。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • に含まれる

        public RealmQuery<E> contains​(String fieldName,
                                      RealmAny value,
                                      Case casing)
        フィールドの値に指定された部分文字列が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 部分文字列。
        casing - 大文字と小文字の処理方法。 これをCase.INSENSITIVEに設定すると、ラテン 1 文字に対してのみ機能します。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • startWith

        public RealmQuery<E> beginsWith​(String fieldName,
                                        String value)
        フィールドの値が指定された string で始まるという条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - string 。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • startWith

        public RealmQuery<E> beginsWith​(String fieldName,
                                        RealmAny value)
        フィールドの値が指定された string で始まるという条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - string 。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • startWith

        public RealmQuery<E> beginsWith​(String fieldName,
                                        String value,
                                        Case casing)
        フィールドの値が指定された部分文字列で始まるという条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 部分文字列。
        casing - 大文字と小文字の処理方法。 これをCase.INSENSITIVEに設定すると、ラテン 1 文字に対してのみ機能します。
        次の値を返します。
        クエリ オブジェクト
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • startWith

        public RealmQuery<E> beginsWith​(String fieldName,
                                        RealmAny value,
                                        Case casing)
        フィールドの値が指定された部分文字列で始まるという条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 部分文字列。
        casing - 大文字と小文字の処理方法。 これをCase.INSENSITIVEに設定すると、ラテン 1 文字に対してのみ機能します。
        次の値を返します。
        クエリ オブジェクト
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • endWith

        public RealmQuery<E> endsWith​(String fieldName,
                                      String value)
        フィールドの値が指定された string で終了することを条件とします。
        パラメーター:
        fieldName - 比較するフィールド。
        value - string 。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • endWith

        public RealmQuery<E> endsWith​(String fieldName,
                                      RealmAny value)
        フィールドの値が指定された string で終了することを条件とします。
        パラメーター:
        fieldName - 比較するフィールド。
        value - string 。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • endWith

        public RealmQuery<E> endsWith​(String fieldName,
                                      String value,
                                      Case casing)
        フィールドの値が指定された部分文字列で終わることを条件とします。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 部分文字列。
        casing - 大文字と小文字の処理方法。 これをCase.INSENSITIVEに設定すると、ラテン 1 文字に対してのみ機能します。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • endWith

        public RealmQuery<E> endsWith​(String fieldName,
                                      RealmAny value,
                                      Case casing)
        フィールドの値が指定された部分文字列で終わることを条件とします。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 部分文字列。
        casing - 大文字と小文字の処理方法。 これをCase.INSENSITIVEに設定すると、ラテン 1 文字に対してのみ機能します。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • のように

        public RealmQuery<E> like​(String fieldName,
                                  String value)
        フィールドの値が指定された部分文字列と一致する条件(ワイルドカード)と一致することを確認します。
        • '*' は [0, n] の Unicode 文字と一致します
        • '?'は、単一の Unicode 文字と一致します。
        パラメーター:
        fieldName - 比較するフィールド。
        value - ワイルドカードstring 。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • のように

        public RealmQuery<E> like​(String fieldName,
                                  RealmAny value)
        フィールドの値が指定された部分文字列と一致する条件(ワイルドカード)と一致することを確認します。
        • '*' は [0, n] の Unicode 文字と一致します
        • '?'は、単一の Unicode 文字と一致します。
        パラメーター:
        fieldName - 比較するフィールド。
        value - ワイルドカードstring 。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • のように

        public RealmQuery<E> like​(String fieldName,
                                  String value,
                                  Case casing)
        フィールドの値が指定された部分文字列と一致する条件(ワイルドカード)と一致することを確認します。
        • '*' は [0, n] の Unicode 文字と一致します
        • '?'は、単一の Unicode 文字と一致します。
        パラメーター:
        fieldName - 比較するフィールド。
        value - ワイルドカードstring 。
        casing - 大文字と小文字の処理方法。 これをCase.INSENSITIVEに設定すると、ラテン 1 文字に対してのみ機能します。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • のように

        public RealmQuery<E> like​(String fieldName,
                                  RealmAny value,
                                  Case casing)
        フィールドの値が指定された部分文字列と一致する条件(ワイルドカード)と一致することを確認します。
        • '*' は [0, n] の Unicode 文字と一致します
        • '?'は、単一の Unicode 文字と一致します。
        パラメーター:
        fieldName - 比較するフィールド。
        value - ワイルドカードstring 。
        casing - 大文字と小文字の処理方法。 これをCase.INSENSITIVEに設定すると、ラテン 1 文字に対してのみ機能します。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - 1 つ以上の引数がクラスまたはフィールド型と一致しない場合。
      • startGroup

        public RealmQuery<E> beginGroup()
        条件のグループ化を開始します(「左括弧」)。 グループはendGroup()を呼び出して閉じる必要があります。
        次の値を返します。
        クエリ オブジェクト。
        以下も参照してください。
        endGroup()
      • endGroup

        public RealmQuery<E> endGroup()
        beginGroup()への呼び出しによって開かれた条件のグループ化を終了しました(「右括弧」)。
        次の値を返します。
        クエリ オブジェクト。
        以下も参照してください。
        beginGroup()
      • or

        public RealmQuery<E> or()
        論理演算子 または 2 つの条件。
        次の値を返します。
        クエリ オブジェクト。
      • および

        public RealmQuery<E> and()
        論理演算子と 2 つの条件 Realm はすべてのクエリ ステートメント間で論理演算子と を自動的に適用するため、これは読みやすさを高めるための手段としてのみ使用されます。
        次の値を返します。
        クエリ オブジェクト
      • ではない

        public RealmQuery<E> not()
        条件を否定します。
        次の値を返します。
        クエリ オブジェクト。
      • isEmpty

        public RealmQuery<E> isEmpty​(String fieldName)
        「空」と見なされる値、つまり空のリスト、長さ 0 の string またはバイト配列を検索する条件。
        パラメーター:
        fieldName - 比較するフィールド。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効ではない場合、またはそのタイプが RealmList、string、またはバイト配列のいずれでない場合。
      • isNotEmpty

        public RealmQuery<E> isNotEmpty​(String fieldName)
        「空ではない」と見なされる値、つまり空でない値を持つリスト、string、またはバイト配列を検索する条件。
        パラメーター:
        fieldName - 比較するフィールド。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効ではない場合、またはそのタイプが RealmList、string、またはバイト配列のいずれでない場合。
      • includeKey

        public RealmQuery<E> containsKey​(String fieldName,
                                         @Nullable
                                         String key)
        辞書フィールドの場合、指定されたキーが含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        key - 検索するキー。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効でない場合。
      • existsValue

        public RealmQuery<E> containsValue​(String fieldName,
                                           @Nullable
                                           Boolean value)
        辞書フィールドの場合、指定された値が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 検索する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効でない場合。
      • existsValue

        public RealmQuery<E> containsValue​(String fieldName,
                                           @Nullable
                                           Byte value)
        辞書フィールドの場合、指定された値が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 検索する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効でない場合。
      • existsValue

        public RealmQuery<E> containsValue​(String fieldName,
                                           @Nullable
                                           Short value)
        辞書フィールドの場合、指定された値が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 検索する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効でない場合。
      • existsValue

        public RealmQuery<E> containsValue​(String fieldName,
                                           @Nullable
                                           Integer value)
        辞書フィールドの場合、指定された値が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 検索する値
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効でない場合。
      • existsValue

        public RealmQuery<E> containsValue​(String fieldName,
                                           @Nullable
                                           Long value)
        辞書フィールドの場合、指定された値が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 検索する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効でない場合。
      • existsValue

        public RealmQuery<E> containsValue​(String fieldName,
                                           @Nullable
                                           Double value)
        辞書フィールドの場合、指定された値が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 検索する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効でない場合。
      • existsValue

        public RealmQuery<E> containsValue​(String fieldName,
                                           @Nullable
                                           Float value)
        辞書フィールドの場合、指定された値が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 検索する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効でない場合。
      • existsValue

        public RealmQuery<E> containsValue​(String fieldName,
                                           @Nullable
                                           String value)
        辞書フィールドの場合、指定された値が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 検索する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効でない場合。
      • existsValue

        public RealmQuery<E> containsValue​(String fieldName,
                                           @Nullable
                                           byte[] value)
        辞書フィールドの場合、指定された値が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 検索する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効でない場合。
      • existsValue

        public RealmQuery<E> containsValue​(String fieldName,
                                           @Nullable
                                           Date value)
        辞書フィールドの場合、指定された値が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 検索する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効でない場合。
      • existsValue

        public RealmQuery<E> containsValue​(String fieldName,
                                           @Nullable
                                           Decimal128 value)
        辞書フィールドの場合、指定された値が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 検索する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効でない場合。
      • existsValue

        public RealmQuery<E> containsValue​(String fieldName,
                                           @Nullable
                                           ObjectId value)
        辞書フィールドの場合、指定された値が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 検索する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効でない場合。
      • existsValue

        public RealmQuery<E> containsValue​(String fieldName,
                                           @Nullable
                                           UUID value)
        辞書フィールドの場合、指定された値が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 検索する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効でない場合。
      • existsValue

        public RealmQuery<E> containsValue​(String fieldName,
                                           RealmAny value)
        辞書フィールドの場合、指定された値が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 検索する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効でない場合。
      • existsValue

        public RealmQuery<E> containsValue​(String fieldName,
                                           RealmModel value)
        辞書フィールドの場合、指定された値が含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        value - 検索する値。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効でない場合。
      • containersEntry

        public RealmQuery<E> containsEntry​(String fieldName,
                                           Map.Entry<String,​?> entry)
        辞書フィールドの場合、指定されたエントリが含まれている条件。
        パラメーター:
        fieldName - 比較するフィールド。
        entry - 検索するエントリ。
        次の値を返します。
        クエリ オブジェクト。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が有効でない場合。
      • 合計

        public previewstring fieldName)
        指定された フィールドの合計を計算します。
        パラメーター:
        fieldName - 合計するフィールド。 数値フィールドと RealmMany フィールドのみがサポートされます。
        次の値を返します。
        一致するオブジェクトの フィールドの合計。 オブジェクトが存在しない場合、または指定されたフィールドの値としてnullが含まれている場合は、 0が返されます。 合計を計算する場合、 null値を持つオブジェクトは無視されます。 RealmAny フィールドに適用すると、数値のみが合計され(バイト/整数/整数/Long/浮動小数点数/ double /Decimal128)、戻り値の型は Decimal128 になります。
        次の例外がスローされます。
        IllegalArgumentException - フィールドが数値型でない場合。
        RealmException - RealmConfiguration.Builder.allowQueriesOnUiThread(boolean)経由でオプトアウトした後に UI スレッドから呼び出された場合
      • 平均

        public double Average( string fieldName)
        指定されたフィールドの平均を返します。 ドット フィールド表記をサポートしていません。
        パラメーター:
        fieldName - 平均を計算するフィールド。 数値フィールドのみがサポートされます。
        次の値を返します。
        クエリ結果内のオブジェクト内の特定のフィールドの平均。 これは、すべての型の数値フィールドで double 型になります。 オブジェクトが存在しない場合、または指定されたフィールドの値としてnullが含まれている場合は、 0が返されます。 平均を計算する場合、 null値を持つオブジェクトは無視されます。
        次の例外がスローされます。
        IllegalArgumentException - フィールドが数値型でない場合。
        RealmException - RealmConfiguration.Builder.allowQueriesOnUiThread(boolean)経由でオプトアウトした後に UI スレッドから呼び出された場合
      • AverageDecimal128

        @Nullable public Decimal128 AverageDecimal128( string fieldName)
        指定されたフィールドの平均を返します。 ドット フィールド表記をサポートしていません。
        パラメーター:
        fieldName - 平均を計算するフィールド。 Decimal128 フィールドのみがサポートされます。 その他の数値型には、 average(String)の使用を検討してください。
        次の値を返します。
        クエリ結果内のオブジェクト内の特定のフィールドの平均。 これは Decimal128 型になります。 オブジェクトが存在しない場合、または指定されたフィールドの値としてnullがすべて含まれている場合、 0は返されます。 平均を計算する場合、 null値を持つオブジェクトは無視されます。
        次の例外がスローされます。
        IllegalArgumentException - フィールドが Decimal128 型でない場合。
        RealmException - RealmConfiguration.Builder.allowQueriesOnUiThread(boolean)経由でオプトアウトした後に UI スレッドから呼び出された場合
      • AverageRealmAny

        @Nullable public Decimal128 AverageRealmAny( string fieldName)
        指定されたフィールドの平均を返します。 ドット フィールド表記をサポートしていません。
        パラメーター:
        fieldName - 平均を計算するフィールド。 RealmMany フィールドのみがサポートされます。 その他のタイプには、 average(String)の使用を検討してください。
        次の値を返します。
        クエリ結果内のオブジェクト内の特定のフィールドの平均。 これは Decimal128 型になります。 オブジェクトが存在しない場合、または指定されたフィールドの値としてnullがすべて含まれている場合、 0は返されます。 平均を計算する場合、 null値を持つオブジェクトは無視されます。
        次の例外がスローされます。
        IllegalArgumentException - フィールドが RealmAny タイプでない場合。
        RealmException - RealmConfiguration.Builder.allowQueriesOnUiThread(boolean)経由でオプトアウトした後に UI スレッドから呼び出された場合
      • min

        @Nullable public Number min( string fieldName)
        フィールドの最小値を検索します。
        パラメーター:
        fieldName - 最小を検索するフィールド。 数値フィールドのみがサポートされます。
        次の値を返します。
        オブジェクトが存在しない場合、または特定のフィールドの値としてnullが含まれている場合は、 nullが返されます。 それ以外の場合は、最小値が返されます。 最小値を決定する場合、 null値を持つオブジェクトは無視されます。
        次の例外がスローされます。
        IllegalArgumentException - フィールドが数値型でない場合。
        RealmException - RealmConfiguration.Builder.allowQueriesOnUiThread(boolean)経由でオプトアウトした後に UI スレッドから呼び出された場合
      • minimumDate

        @Nullable public Date minimumDate( string fieldName)
        フィールドの最小値を検索します。
        パラメーター:
        fieldName - フィールド名
        次の値を返します。
        オブジェクトが存在しない場合、または特定の日付フィールドの値としてnullが含まれている場合は、 nullが返されます。 それ以外の場合は、最小日付が返されます。 最小日付を決定する場合、 null値を持つオブジェクトは無視されます。
        次の例外がスローされます。
        UnsupportedOperationException - クエリが有効でない場合(「構文エラー」)。
        RealmException - RealmConfiguration.Builder.allowQueriesOnUiThread(boolean)経由でオプトアウトした後に UI スレッドから呼び出された場合
      • minRealmAny

        public RealmAny minRealmAny( string fieldName)
        RealmAnyフィールドの最小値を検索します。
        パラメーター:
        fieldName - RealmAny 値を含む フィールド。
        次の値を返します。
        オブジェクトが存在しない場合、または指定された RealmAny フィールドの値としてnullが含まれている場合は、 RealmAny.Type.NULLが返されます。 それ以外の場合は、最小の RealmAny が返されます。 最小 RealmAny を決定する場合、 null値を持つオブジェクトは無視されます。 RealmAny 値が比較される方法の詳細については、 RealmAnyのドキュメントを参照してください。
        次の例外がスローされます。
        UnsupportedOperationException - クエリが有効でない場合(「構文エラー」)。
        RealmException - RealmConfiguration.Builder.allowQueriesOnUiThread(boolean)経由でオプトアウトした後に UI スレッドから呼び出された場合
      • 最大

        @Nullable public Number max( string fieldName)
        フィールドの最大値を検索します。
        パラメーター:
        fieldName - の最大値を検索するフィールド。 数値フィールドのみがサポートされます。
        次の値を返します。
        オブジェクトが存在しない場合、または特定のフィールドの値としてnullが含まれている場合は、 nullが返されます。 それ以外の場合は、最大値が返されます。 最大値を決定する際、 null値を持つオブジェクトは無視されます。
        次の例外がスローされます。
        IllegalArgumentException - フィールドが数値型でない場合。
        RealmException - RealmConfiguration.Builder.allowQueriesOnUiThread(boolean)経由でオプトアウトした後に UI スレッドから呼び出された場合
      • maximumDate

        @Nullable public Date maximumDate( string fieldName)
        フィールドの最大値を検索します。
        パラメーター:
        fieldName - フィールド名。
        次の値を返します。
        オブジェクトが存在しない場合、または特定の日付フィールドの値としてnullが含まれている場合は、 nullが返されます。 それ以外の場合は、最大日付が返されます。 最大日付を決定する際、 null値を持つオブジェクトは無視されます。
        次の例外がスローされます。
        UnsupportedOperationException - クエリが有効でない場合(「構文エラー」)。
      • maxRealmAny

        public RealmAny maxRealmAny( string fieldName)
        RealmAnyフィールドの最大値を検索します。
        パラメーター:
        fieldName - RealmAny 値を含む フィールド。
        次の値を返します。
        オブジェクトが存在しない場合、または指定された RealmAny フィールドの値としてnullが含まれている場合は、 RealmAny.Type.NULLが返されます。 それ以外の場合、最大 RealmAny が返されます。 最大 RealmAny を決定する場合、 null値を持つオブジェクトは無視されます。 RealmAny 値が比較される方法の詳細については、 RealmAnyのドキュメントを参照してください。
        次の例外がスローされます。
        UnsupportedOperationException - クエリが有効でない場合(「構文エラー」)。
      • findAll

        public RealmResults<E> findAll()
        クエリ条件を満たすすべてのオブジェクトを検索します。

        UI スレッドから重いクエリを起動すると、フレームワークや ARN もドロップされる可能性があります。 そのような操作は推奨されないため、デフォルトでは許可されていません。 このような動作を防ぐには、 RealmConfigurationを使用して Realm を取得し、 RealmConfiguration.Builder.allowQueriesOnUiThread(boolean)を明示的にfalseに設定します。 こうすると、非 UI スレッドからクエリを起動するよう強制されます。それ以外の場合、このメソッドへの呼び出しではRealmExceptionがスローされます。 あるいは、 findAllAsync()を使用することもできます。

        次の値を返します。
        オブジェクトを含むRealmResults 。 条件に一致するオブジェクトがない場合は、0 オブジェクトを含むリストが返されます。
        次の例外がスローされます。
        RealmException - RealmConfiguration.Builder.allowQueriesOnUiThread(boolean)経由でオプトアウトした後に UI スレッドから呼び出された場合
        以下も参照してください。
        RealmResults
      • findAllAsync

        public RealmResults<E> findAllAsync()
        クエリ条件を満たすすべてのオブジェクトを検索します。 このメソッドは、Doop スレッドからのみ使用できます。
        次の値を返します。
        すぐに空のRealmResultsが生成される。 クエリの完了時に通知されるように、ユーザーはリスナーRealmResults.addChangeListener(RealmChangeListener)を登録する必要があります。
        以下も参照してください。
        RealmResults
      • sort

        public RealmQuery<E> sort​(String fieldName)
        クエリ結果を特定のフィールド名で昇順にソートします。

        ソートは現在、「ラテンの基本」、「ラテンの追加」、「ラテンの拡張 A」、「ラテンの拡張 B」の文字セットに制限されています(UTF-8 範囲 0 ~ 591)。 他の文字セットの場合、ソートしても効果はありません。

        パラメーター:
        fieldName - 並べ替えるフィールド名。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が存在しない場合。
        IllegalStateException - ソート順序がすでに定義されている場合。
      • sort

        public RealmQuery<E> sort​(String fieldName,
                                  Sort sortOrder)
        指定されたフィールド名と順序でクエリ結果をソートします。

        ソートは現在、「ラテンの基本」、「ラテンの追加」、「ラテンの拡張 A」、「ラテンの拡張 B」の文字セットに制限されています(UTF-8 範囲 0 ~ 591)。 他の文字セットの場合、ソートしても効果はありません。

        パラメーター:
        fieldName - 並べ替えるフィールド名。
        sortOrder - 結果を並べ替える方法。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が存在しない場合。
        IllegalStateException - ソート順序がすでに定義されている場合。
      • sort

        public RealmQuery<E> sort​(String fieldName1,
                                  Sort sortOrder1,
                                  String fieldName2,
                                  Sort sortOrder2)
        指定された順序内の特定のフィールド名でクエリ結果をソートします。 fieldName2fieldName1の 値が等しい場合にのみ使用されます。

        ソートは現在、「ラテンの基本」、「ラテンの追加」、「ラテンの拡張 A」、「ラテンの拡張 B」の文字セットに制限されています(UTF-8 範囲 0 ~ 591)。 他の文字セットの場合、ソートしても効果はありません。

        パラメーター:
        fieldName1 - 最初のフィールド名
        sortOrder1 - 最初のフィールドのソート順
        fieldName2 - 2 番目のフィールド名
        sortOrder2 - 2 番目のフィールドのソート順序
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が存在しない場合。
        IllegalStateException - ソート順序がすでに定義されている場合。
      • sort

        public RealmQuery<E> sort​(String[] fieldNames,
                                  Sort[] sortOrders)
        指定された順序内の特定のフィールド名でクエリ結果をソートします。 後のフィールドは、前のフィールド値が等しい場合にのみ使用されます。

        ソートは現在、「ラテンの基本」、「ラテンの追加」、「ラテンの拡張 A」、「ラテンの拡張 B」の文字セットに制限されています(UTF-8 範囲 0 ~ 591)。 他の文字セットの場合、ソートしても効果はありません。

        パラメーター:
        fieldNames - ソートするフィールド名の配列。
        sortOrders - フィールド名を並べ替える方法。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が存在しない場合。
        IllegalStateException - ソート順序がすでに定義されている場合。
      • distinct

        public RealmQuery<E> distinct​(String firstFieldName,
                                      String... remainingFieldNames)
        特定の クラスのオブジェクトの個別セットを選択します。 複数の異なるフィールドが指定されている場合、フィールド内の値の一意のすべての組み合わせが返されます。 複数に一致する場合、返されるオブジェクトは未定義です。 Unless the result is sorted, then the first object will be returned.
        パラメーター:
        firstFieldName - 個別のオブジェクトを検索するときに使用する最初のフィールド名。
        remainingFieldNames - フィールド値の一意の組み合わせをすべて決定する場合の残りのフィールド名。
        次の例外がスローされます。
        IllegalArgumentException - フィールド名が空またはnullの場合、 が存在しないか、サポートされていないタイプであるか、リンクされたフィールドを指している場合。
        IllegalStateException - 異なるフィールド名がすでに定義されている場合。
      • limit

        public RealmQuery<E> limit​(long limit)
        クエリがより多くのオブジェクトと一致した場合に返されるオブジェクトの数を制限します。

        このメソッドをsort(String)およびdistinct(String, String...)と組み合わせて使用すると、追加された順序で実行され、終了結果に影響する可能性があることに注意してください。

        パラメーター:
        limit - &ge; 1の制限。
        次の例外がスローされます。
        IllegalArgumentException - 提供されたlimitが 1 未満の場合。
      • equalsTrue

        public RealmQuery<E> alwaysTrue()
        この述語は常に一致します。
      • automaticFalse

        public RealmQuery<E> alwaysFalse()
        この述語は一致することがないため、クエリは常に 0 の結果を返します。
      • rawPredate

        public RealmQuery<E> rawPredicate​(String predicate,
                                          Object... arguments)
        RQLを使用して、テキストベースの述語を作成します。 この述語は、他の未加工またはタイプセーフな述語と組み合わせることができ、Realm 値を引数として受け入れます。

        生の述語で使用されるクラス名とプロパティ名は、Realm モデル クラスで定義された名前、またはRealmClassまたはRealmFieldの注釈を使用して定義された内部名のいずれかになります。 クラス名またはプロパティ名にスペースが含まれている場合は、エスケープする必要があります。

        引数は、string 述語内で $argment_index として定義されます。$argment_index は、引数リスト内の引数の位置を指定する 10 進数の整数です。 最初の引数は $0、2 番目の引数は $1 によって参照されます。

        の詳細な説明については、 これらのDocsRQL を参照してください。

         例:
         
         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);
         
         
        パラメーター:
        predicate - RQL述語。
        arguments - 述語の Realm 値。
        次の例外がスローされます。
        IllegalArgumentException - 構文エラーが発生した場合。
      • getRealm

        public Realm getRealm()
        このクエリが属するRealmインスタンスを返します。

        返されたインスタンスでCloseable.close()を呼び出すことは、元の Realm インスタンスで呼び出すのと同じであるため推奨されません。これにより、Realm はクエリを無効化し、完全に閉じてしまう可能性があります。

        次の値を返します。
        Realm このクエリが属する インスタンス。
        次の例外がスローされます。
        IllegalStateException - Realm がDynamicRealmのインスタンスであるか、 Realmがすでに閉じられている場合。
      • get Description

        public string get Description()
        このクエリのテキスト説明を返します。
        次の値を返します。
        クエリのテキスト説明。
      • getTypeQueryed

        public string getTypeQueryed()
        クエリされているタイプの内部 Realm 名を返します。
        次の値を返します。
        クエリ対象の Realm モデル クラスの内部名。
      • getQueryPointer

        public long getQueryPointer()
        基礎となる C++ クエリへのポインターを返します。 このメソッドは、回避策が困難であり、警告なしで変更される可能性があるため内部で考慮する必要があるアーキテクチャ設計の選択のためにのみ公開されています。
        次の値を返します。
        基礎となる C++ クエリへのポインター。
      • findFirst

        @Nullable public E findFirst()
        クエリ条件を満たす最初のオブジェクトを検索します。

        UI スレッドから重いクエリを起動すると、フレームワークや ARN もドロップされる可能性があります。 そのような操作は推奨されませんが、デフォルトでは許可されています。 このような動作を防ぐには、 RealmConfigurationを使用して Realm を取得し、 RealmConfiguration.Builder.allowQueriesOnUiThread(boolean)を明示的にfalseに設定します。 こうすると、非 UI スレッドからクエリを起動するよう強制されます。それ以外の場合、このメソッドへの呼び出しではRealmExceptionがスローされます。 あるいは、 findFirstAsync()を使用することもできます。

        次の値を返します。
        見つかったオブジェクトをスキャンするか、クエリ条件に一致するオブジェクトがない場合はnullになります。
        次の例外がスローされます。
        RealmException - RealmConfiguration.Builder.allowQueriesOnUiThread(boolean)経由でオプトアウトした後に UI スレッドから呼び出された場合
        以下も参照してください。
        RealmObject
      • findFirstAsync

        public E findFirstAsync()
        findFirst()と同様ですが、ワーカー スレッドで非同期に実行されます。 クエリが完了したときに通知を受け取るには、返されたRealmObjectにリスナーを登録する必要があります。 クエリされたRealmObjectに変更が加えられた場合でも、登録されたリスナーもトリガーされます。 RealmObjectが削除されると、リスナーが最後に 1 回呼び出され、その後停止します。 クエリは再実行されません。
        次の値を返します。
        すぐに空のRealmObjectisLoaded() == falseを使用する。 返されたオブジェクトがロードされる前に、そのオブジェクトのいずれかのフィールドにアクセスしようとすると、 IllegalStateExceptionがスローされます。
        次の例外がスローされます。
        IllegalStateException - これが非ルーパー スレッドで呼び出された場合。