RangeCount – função de script e gráfico
RangeCount() retorna o número de valores, de texto e numéricos, na expressão ou campo.
Sintaxe:
RangeCount(first_expr[, Expression])
Tipo de dados de retorno: inteiro
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 contendo os dados que serão contados.
- Expression: Expressões ou campos opcionais contendo dados adicionais a serem contados.
Limitações:
Valores NULL não são contados.
Exemplos:
Exemplo | Resultado |
---|---|
RangeCount (1,2,4) |
Retorna 3 |
RangeCount (2,'xyz') |
Retorna 2 |
RangeCount (null( )) | Retorna 0 |
RangeCount (2,'xyz', null()) | Retorna 2 |
Exemplo: (usando expressão)
RangeCount (Above(MyField,1,3))
Retorna o número de valores contidos nos três resultados do MyField. Ao especificar o segundo e terceiro argumentos da função Above() como 3, retorna os valores dos três campos acima da linha atual, onde há linhas suficientes, que são usadas como entrada para a função RangeSum().
MyField | RangeCount(Above(MyField,1,3)) |
---|---|
10 |
0 |
2 | 1 |
8 | 2 |
18 | 3 |
5 | 3 |
9 | 3 |
Dados usados nos exemplos:
RangeTab:
LOAD * INLINE [
MyField
10
2
8
18
5
9
] ;
Exemplo: (em formato 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, RangeCount(Field1,Field2,Field3) as MyRangeCount 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 deMyRangeCount para cada registro na tabela.
RangeID | MyRangeCount |
---|---|
1 | 3 |
2 | 3 |
3 | 3 |
4 | 3 |
5 | 3 |
6 | 3 |