合計
指定されたプロパティの合計を計算します。
プロパティの集計結果が指定された型に収まらない場合、その型の Kotlin のセマンティクスに従って結果がオーバーフローします。 たとえば、プロパティfloor
がByte
で、指定された型もByte
である場合、例は次のようになります。 query.sum("floor", Short::class)
の場合、 Byte.MAX_VALUEより大きい値の場合、結果はオーバーフローします。 クエリでオーバーフローする可能性の低いタイプを指定することで、この制限を回避できます。例を以下に示します。 query.sum("floor", Int::class)
。 この場合、集計値はInt
になります。
このメソッドの化されたバージョンは、拡張関数として、 query.sum<YourClass>(...)
として利用することもできます。 アクセスするにはio.realm.query.sum
をインポートします。
Return
一致するオブジェクトの フィールドの合計。 オブジェクトが存在しない場合、または指定されたプロパティの値としてオブジェクトがすべてnull
である場合、 0
が返されます。 合計を計算する場合、 null
値を持つオブジェクトは無視されます。
パラメーター
プロパティ
合計するプロパティ。 数値プロパティのみがサポートされます。
タイプ
結果として得られる集計値の型。プロパティ自体の型と一致する場合と一致しない場合があります。