soma
Calcula a soma da propriedade fornecida .
Se o resultado agregado da propriedade não se encaixa no tipo especificado, o resultado estourará seguindo a semântica do Kotlin para esse tipo. Por exemplo, se a propriedade floor
for um Byte
e o tipo especificado também for Byte
, por exemplo query.sum("floor", Short::class)
, o resultado estourar para valores maiores que Byte.MAX_VALUE. É possível contornar essa limitação especificando um tipo que tenha menos probabilidade de estourar na query, por exemplo query.sum("floor", Int::class)
. Neste caso, o valor agregado será um Int
.
Uma versão reificada deste método também está disponível como uma função de extensão, query.sum<YourClass>(...)
. Importe io.realm.query.sum
para acessá-lo.
Return
a soma dos campos dos objetos correspondentes. Se não existirem objetos ou todos eles tiverem null
como o valor para a propriedade fornecida, 0
será retornado. Ao calcular a soma, objetos com valores null
são ignorados.
Parâmetros
a propriedade a ser somada. Somente propriedades numéricas são suportadas.
o tipo do valor agregado resultante, que pode ou não coincidir com o tipo da própria propriedade.
Lança
se a propriedade não for um Number ou um Chart , ou se for um RealmInstant, ou se o tipo não puder ser utilizado para representar a propriedade.