Partilhar via


Função INDEX ER

A função INDEX devolve um valor Contentor (registo) selecionado através da utilização do índice numérico especificado na lista especificada. Se o índice estiver fora do intervalo para os registos na lista especificada, é gerada uma exceção.

Sintaxe

INDEX (list, index)

Argumentos

list: Lista de registos

O caminho válido de uma origem de dados do tipo de dados Lista de registos.

index: Número inteiro

Um índice numérico que indica a posição do registo pretendido na lista especificada.

Nota

Dado que é utilizada uma numeração de base um para esta função, especifique o valor 1 para devolver o primeiro registo da lista especificada.

Valores devolvidos

Contentor (registo)

O valor do registo resultante.

Exemplo 1

Se introduzir a origem de dados DS do tipo Campo calculado que contenha a expressão SPLIT ("A|B|C", "|"), a expressão DS.Value devolve um valor de texto "B" para o segundo registo desta lista de registos. A expressão INDEX (SPLIT ("A|B|C", "|"), 2).Value também devolve o valor de texto "B".

Exemplo 2

Se introduzir a origem de dados DS do tipo Campo calculado que contenha a expressão SPLIT ("A|B|C", "|"), a expressão INDEX (SPLIT ("A|B|C", "|"), 4).Value gera uma exceção em runtime.

Recursos adicionais

Funções de lista