总和

摘要 乐趣 <t : Any> 总和(属性字符串类型 KClass < T >): RealmScalarQuery<t>

计算给定属性的总和。

如果属性的聚合结果不适合指定的类型,则根据 Kotlin 针对所述类型的语义,结果将发生溢出。 例如,如果属性floorByte ,且指定的类型也是Byte ,例如 query.sum("floor", Short::class) ,对于大于Byte.MAX_VALUE的值,结果将溢出。 可以通过指定在查询中不太可能溢出的类型来规避此限制,例如 query.sum("floor", Int::class) 。 在这种情况下,聚合值将是Int

此方法的具体化版本也可用作扩展函数query.sum<YourClass>(...) 。 导入io.realm.query.sum以访问它。

返回

匹配对象的字段总和。 如果对象不存在,或者给定属性的值为null ,则返回0 。 计算总和时,具有null值的对象将被忽略。

参数

属性

要求和的属性。 仅支持Number属性。

类型

聚合结果值的类型,可能与属性本身的类型一致,也可能不一致。

抛出异常

如果属性不是数字字符,或者是RealmInstant ,或者类型不能用于表示属性