FieldIndex() retorna a posição do valor de campo value encontrado no campo field_name (por ordem de carga).
Sintaxe:
FieldIndex(field_name , value)
Tipo de dados de retorno: inteiro
Argumentos:
- field_name: Nome do campo para o qual é exigido o índice. Por exemplo, a coluna em uma tabela. Deve ser dado como um valor de caracteres. Isto significa que o nome do campo deve ser colocado entre aspas simples.
- value: O valor do campo field_name.
Limitações:
-
A classificação por valores y em gráficos ou por colunas de expressão em tabelas não é permitida quando essa função de gráfico é usada em qualquer uma das expressões do gráfico. Essas alternativas de classificação estão, portanto, automaticamente desabilitadas. Quando você usar essa função de gráfico em uma visualização ou tabela, a classificação da visualização será revertida para a entrada classificada dessa função. Essa limitação não se aplica à função de script equivalente.
-
Se value valor não for encontrado entre os valores do campo field_name, 0 será retornado.
Exemplos:
Adicione os dados de exemplo abaixo ao seu documento e execute-o. Os exemplos a seguir usam o campo: First name da tabelaNames.
| Exemplo | Resultado |
|---|---|
|
Função de gráfico - em uma tabela contendo a dimensão First name, adicione como medida: FieldIndex ('First name','John') |
1, porque 'John' aparece primeiro na ordem de carregamento do campo First name. Observe que em uma lista, John apareceria como segundo de cima para baixo, porque é classificada em ordem alfabética e não na ordem de carregamento. |
|
Função de gráfico com First name: FieldIndex ('First name','Peter') |
4, porque FieldIndex() retorna apenas um valor, que é a primeira ocorrência na ordem de carregamento. |
|
Função de script, considerando que a tabela Names está carregada, como nos dados de exemplo: John1: Load FieldIndex('First name','John') as MyJohnPos Resident Names; |
MyJohnPos=1, porque 'John' aparece primeiro na ordem de carregamento do campo First name. Observe que em uma lista, John apareceria como segundo de cima para baixo, porque é classificada em ordem alfabética e não na ordem de carregamento. |
|
Função de script com Names: Peter1: Load FieldIndex('First name','Peter') as MyPeterPos Resident Names; |
MyPeterPos=4, porque FieldIndex() retorna apenas um valor, que é a primeira ocorrência na ordem de carregamento. |
Dados usados no exemplo:
Names:
LOAD * inline [
"First name"|"Last name"|Initials|"Has cellphone"
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC |No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');
John1:
Load FieldIndex('First name','John') as MyJohnPos
Resident Names;
Peter1:
Load FieldIndex('First name','Peter') as MyPeterPos
Resident Names;
