RangeSum – função de script e gráfico
RangeSum() retorna a soma de um intervalo de valores. Todos os valores não numéricos são tratados como 0, diferente do operador +.
Sintaxe:
RangeSum(first_expr[, Expression])
Tipo de dados de retorno: numérico
Argumentos:
O argumento dessa função pode conter funções inter-registro, o que por si só retorna uma lista de valores.
- first_expr: a expressão ou campo que contém os dados a serem somados.
- Expression: expressões ou campos opcionais que contêm o intervalo de dados a ser somado. Várias expressões adicionais podem ser usadas.
Limitações:
A função RangeSum trata todos os valores não numéricos como 0, diferentemente do operador +.
Exemplos:
| Exemplo | Resultado |
|---|---|
| RangeSum (1,2,4) |
Retorna 7 |
| RangeSum (5,'abc') | Retorna 5 |
| RangeSum (null( )) |
Retorna 0 |
Exemplo: (usando a expressão)
RangeSum (Above(MyField,0,3))
Retorna a soma de três valores de MyField): na linha atual e duas linhas acima da atual. Ao especificar o terceiro argumento como 3, a função Above() retorna três valores, em que há linhas suficientes acima, que são tomadas como entrada na função RangeSum().
| MyField | RangeSum(Above(MyField,0,3)) |
|---|---|
| 10 | 10 |
|
2 |
12 |
| 8 | 20 |
| 18 | 28 |
| 5 | 31 |
| 9 | 32 |
Dados usados nos exemplos:
RangeTab:
LOAD * INLINE [
MyField
10
2
8
18
5
9
] ;
Exemplo: (em forma de tabela)
Adicione o script de exemplo ao seu documento e execute-o. Em seguida, adicione pelo menos os campos listados na coluna de resultados a um documento para ver o resultado.
RangeTab3:
LOAD recno() as RangeID, Rangesum(Field1,Field2,Field3) as MyRangeSum INLINE [
Field1, Field2, Field3
10,5,6
2,3,7
8,2,8
18,11,9
5,5,9
9,4,2
];
A tabela resultante mostra os valores retornados deMyRangeSum para cada registro na tabela.
| RangeID | MyRangeSum |
|---|---|
| 1 | 21 |
| 2 | 12 |
| 3 | 18 |
| 4 | 38 |
| 5 | 19 |
| 6 | 15 |