Realm 。コレクション

コレクション内の値の数。

nullはコレクションに対して有効な値であるかどうか。

コレクション内の値の型。

ライブコレクション インスタンスが変更されたときに呼び出されるリスナーcallbackを追加します。

パラメーター:

• コールバック
• タイプ: function

• 変更が発生したときに呼び出される関数。 コールバック関数は 2 つの引数を指定して呼び出されます。

  • collection: 変更されたコレクション インスタンス
  • changes: insertions 、 newModifications 、 oldModifications 、 deletionsのキーを含む辞書で、それぞれ挿入、アップデート、または削除されたコレクション内のインデックスのリストが含まれています。 deletionsとoldModificationsは変更が発生する前のコレクションのインデックスであり、 insertionsとnewModificationsはコレクションの新しいバージョンのインデックスです。

次の例外をスローします。

wines.addListener((collection, changes) => {
 // collection === wines
 console.log(`${changes.insertions.length} insertions`);
 console.log(`${changes.modifications.length} modifications`);
 console.log(`${changes.deletions.length} deletions`);
 console.log(`new size of collection: ${collection.length}`);
});

コレクション内の値またはコレクション内のすべてのオブジェクト内の指定された プロパティの値の平均を計算します。コレクションが空の場合はundefinedです。

int、float、double プロパティでのみサポートされます。 このメソッドではnull値は完全に無視され、平均に係数は考慮されません。

パラメーター:

• プロパティ 任意
• タイプ: string

• オブジェクトのコレクションの場合、プロパティは の平均になります。

次の例外をスローします。

パラメーター:

• コールバック
• タイプ: function

• コレクション内の各オブジェクトで実行する関数。 この関数がすべてのオブジェクトに対してtrueを返す場合、このメソッドはtrueを返します。 この関数は 3 つの引数を取ります。

  • object - コレクション内で処理されている現在オブジェクト。
  • index - コレクション内で処理されているオブジェクトのインデックス。
  • collection - コレクション自体。

• このArg 任意
• タイプ: object

• callbackが呼び出されるときのthisの値。

指定されたクエリによってフィルタリングされているこのコレクションを表す新しい結果を返します。

パラメーター:

• クエリ
• タイプ: string

• コレクションのオブジェクトをフィルタリングするために使用されるクエリ。

• arg 任意 再現可能
• タイプ: any

• 後続の各引数はプレースホルダー（例: クエリ内の$0 、 $1 、 $2 、...）を含むドキュメントをインポートします。

次の例外をスローします。

let merlots = wines.filtered('variety == "Merlot" && vintage 

パラメーター:

• コールバック
• タイプ: function

• コレクション内の各オブジェクトで実行する関数。 この関数がtrueを返す場合、そのオブジェクトはこのメソッドによって返されます。 この関数は 3 つの引数を取ります。

  • object - コレクション内で処理されている現在オブジェクト。
  • index - コレクション内で処理されているオブジェクトのインデックス。
  • collection - コレクション自体。

• このArg 任意
• タイプ: object

• callbackが呼び出されるときのthisの値。

パラメーター:

• コールバック
• タイプ: function

• コレクション内の各オブジェクトで実行する関数。 この関数がtrueを返す場合、そのオブジェクトのインデックスがこのメソッドによって返されます。 この関数は 3 つの引数を取ります。

  • object - コレクション内で処理されている現在オブジェクト。
  • index - コレクション内で処理されているオブジェクトのインデックス。
  • collection - コレクション自体。

• このArg 任意
• タイプ: object

• callbackが呼び出されるときのthisの値。

パラメーター:

• コールバック
• タイプ: function

• コレクション内の各オブジェクトで実行する関数。 この関数は 3 つの引数を取ります。

  • object - コレクション内で処理されている現在オブジェクト。
  • index - コレクション内で処理されているオブジェクトのインデックス。
  • collection - コレクション自体。

• このArg 任意
• タイプ: object

• callbackが呼び出されるときのthisの値。

コレクション内の指定されたオブジェクトのインデックスを検索します。

パラメーター:

• オブジェクト
• タイプ: T

• コレクションで検索する値。

次の例外をスローします。

このコレクションが空かどうかを確認します。

このコレクションが削除されておらず、有効な Realm の一部であるかどうかを確認します。

コレクション内のすべてのオブジェクトを string に結合します。

パラメーター:

• セパレーター 任意
• タイプ: string
• デフォルト: ","

• コレクション内の各オブジェクトで呼び出されるtoString()メソッドの戻り値を区別する string。

パラメーター:

• コールバック
• タイプ: function

• コレクション内の各オブジェクトで実行する関数。 この関数は 3 つの引数を取ります。

  • object - コレクション内で処理されている現在オブジェクト。
  • index - コレクション内で処理されているオブジェクトのインデックス。
  • collection - コレクション自体。

• このArg 任意
• タイプ: object

• callbackが呼び出されるときのthisの値。

コレクション内の値、またはコレクション内のすべてのオブジェクト内の指定されたプロパティの最大値を返します。コレクションが空の場合はundefinedです。

int、float、double、date プロパティでのみサポートされます。 null値はこのメソッドによって完全に無視され、返されません。

パラメーター:

• プロパティ 任意
• タイプ: string

• オブジェクトのコレクションの場合、 プロパティは最大 の値を取得します。

次の例外をスローします。

コレクション内の値、またはコレクション内のすべてのオブジェクト内の指定されたプロパティの最小値を返します。コレクションが空の場合はundefinedです。

int、float、double、date プロパティでのみサポートされます。 null値はこのメソッドによって完全に無視され、返されません。

パラメーター:

• プロパティ 任意
• タイプ: string

• オブジェクトのコレクションの場合、 プロパティは の最小値をとります。

次の例外をスローします。

パラメーター:

• コールバック
• タイプ: function

• コレクション内の各オブジェクトで実行する関数。 この関数は 4 つの引数を取ります。

  • previousValue - コールバックの最後の呼び出しで返された値、または指定されている場合はinitialValue 。
  • object - コレクション内で処理されている現在オブジェクト。
  • index - コレクション内で処理されているオブジェクトのインデックス。
  • collection - コレクション自体。

• initialValue 任意
• タイプ: object

• callbackの最初の呼び出しの最初の引数として使用する値。

次の例外をスローします。

パラメーター:

• コールバック
• タイプ: function

• コレクション内の右から左まで、各オブジェクトに対して実行する関数。 この関数は 4 つの引数を取ります。

  • previousValue - コールバックの最後の呼び出しで返された値、または指定されている場合はinitialValue 。
  • object - コレクション内で処理されている現在オブジェクト。
  • index - コレクション内で処理されているオブジェクトのインデックス。
  • collection - コレクション自体。

• initialValue 任意
• タイプ: object

• callbackの最初の呼び出しの最初の引数として使用する値。

次の例外をスローします。

コレクション インスタンスからすべてのcallbackリスナーを削除します。

コレクション インスタンスからリスナーcallbackを削除します。

パラメーター:

• コールバック
• タイプ: function

• 以前にaddListenerメソッドを通じてリスナーとして追加されたコールバック関数。

次の例外をスローします。

パラメーター:

• 始める 任意
• タイプ: number
• デフォルト: 0

• 開始インデックス。 負の場合、開始インデックスはコレクションの末尾からカウントされます。

• end 任意
• タイプ: number

• 終了インデックス。 終了インデックスまでのオブジェクト（終了インデックスを含まない）は戻り値に含まれます。 負の場合、終了インデックスはコレクションの末尾からカウントされます。 省略した場合、開始インデックスのすべてのオブジェクトが戻り値に含まれます。

コレクションのスナップショットを作成します。

元のコレクションに追加された値と削除された値は、プロパティの値が適用されたフィルターと一致するか一致しないように変更された場合も含め、このメソッドによって返される結果には反映されません。

これは ディープ スナップショットではあり ません 。このスナップショットに含まれる Realm オブジェクトは、変更が加えられるたびに更新を継続し、Realm から削除された場合は、それぞれのインデックスのnullに置き換えられます。

次の例外をスローします。

パラメーター:

• コールバック
• タイプ: function

• コレクション内の各オブジェクトで実行する関数。 この関数がtrueを返す場合、このメソッドはtrueを返します。 この関数は 3 つの引数を取ります。

  • object - コレクション内で処理されている現在オブジェクト。
  • index - コレクション内で処理されているオブジェクトのインデックス。
  • collection - コレクション自体。

• このArg 任意
• タイプ: object

• callbackが呼び出されるときのthisの値。

このコレクションのソートされたビューを表す新しい結果を返します。

Realm オブジェクトのコレクションは、それらのオブジェクトの 1 つ以上のプロパティ、またはそれらのオブジェクトにリンクされたオブジェクトのプロパティの 1 つ以上でソートできます。 1 つのプロパティで並べ替えるには、そのプロパティの名前をsorted()に渡します。その後、並べ替えを元に戻すかどうかを示すブール値を任意で渡します。 複数のプロパティの場合、ソートするプロパティをリストするソート記述子の配列を渡す必要があります。

他の型のコレクションは、値のプロパティではなく、値自体にソートされるため、プロパティ名やソート記述子を指定する必要はありません。

パラメーター:

• descriptor 任意
• タイプ: stringまたは[SortDescriptor, ...]

• コレクションを並べ替えるプロパティ名。

• 逆 任意
• タイプ: boolean
• デフォルト: false

• 昇順ではなく降順でソートします。 descriptorがソート記述子の配列である場合、指定されない可能性があります。

次の例外をスローします。

// Sort wines by age
wines.sorted('age')

// Sort wines by price in descending order, then sort ties by age in
// ascending order
wines.sorted([['price', false], ['age']])

// Sort a list of numbers in ascending order
let sortedPrices = wine.pricesSeen.sort()

// Sort people by how expensive their favorite wine is
people.sort("favoriteWine.price")

コレクション内の または コレクション内のすべてのオブジェクト内の指定された プロパティの値の合計を計算します。コレクションが空の場合は 0 になります。

int、float、double プロパティでのみサポートされます。 null values are ignored entirely by this method.

パラメーター:

• プロパティ 任意
• タイプ: string

• オブジェクトのコレクションの場合、 は の合計を取得します。

次の例外をスローします。

これはvalues()メソッドと同じメソッドです。 この存在により、コレクションが反復可能になり、ES6 for-ofループ、 ...展開演算子などで使用できるようになります。

for (let object of collection) {
  // do something with each object
}

これは ES6 イテレータです。

プロパティ:

• 次へ
• タイプ: function

• 次の 2 つのプロパティを持つオブジェクトを返します。

  • done - イテレータがコレクション内の項目を反復処理している場合はtrue 、それ以外の場合はfalse
  • value - コレクション内の反復処理される次の項目、またはundefined doneが の場合はtrue

• Symbol.itator
• タイプ: function

• このメソッドは単純にthisを返すため、このイテレータ自体を反復可能にします（つまり for-ofループで使用可能で、 ...展開演算子など）を使用する必要があります。

並べ替え記述子は、ドットで区切られた 1 つ以上のプロパティ名を含む string、または2 つの項目を含む配列です: [propertyName, reverse] 。