Função de ER SPLIT

A função SPLIT divide a cadeia de entrada especificada em subcadeias e devolve o resultado como um novo valor Lista de registos.

Sintaxe 1

SPLIT (input, length)

Esta sintaxe é utilizada para dividir a cadeia de entrada especificada em subcadeias, cada uma das quais com o comprimento especificado.

Sintaxe 2

SPLIT (input, delimiter)

Esta sintaxe é utilizada para dividir a cadeia de entrada especificada em subcadeias, com base no delimitador especificado.

Argumentos

input: Cadeia

O texto a dividir.

length: Número inteiro

O comprimento máximo de uma única subcadeia.

delimiter: Cadeia

Um delimitador utilizado para separar subcadeias.

Valores de retorno

Lista de registos

A lista de registos resultante.

Notas de utilização

A estrutura de registo da lista devolvida consiste no campo de Valor do tipo Cadeia. Todos os registos da lista devolvidos contêm subcadeias geradas neste campo.

Se o argumento delimiter estiver vazio, a nova lista devolvida consiste num registo com o campo Valor do tipo Cadeia. Este campo contém o texto de entrada.

Se o argumento input estiver vazio, é devolvida uma nova lista vazia. Se o argumento input ou delimiter não for especificado (nulo), uma exceção da aplicação é iniciada.

Exemplo 1

SPLIT ("abcd", 3) devolve uma nova lista que consiste em dois registos com o campo Valor do tipo Cadeia. O campo Valor no primeiro registo contém o texto "abc" e o campo Valor no segundo registo contém o texto "d".

Exemplo 2

SPLIT ("XAb aBy", "aB") devolve uma nova lista que consiste em três registos com o campo Valor do tipo Cadeia. O campo Valor no primeiro registo contém o texto "X", o campo Valor no segundo registo contém o texto " " e o campo Valor no terceiro registo contém o texto "y".

Exemplo 3

Pode utilizar a função INDEX para aceder a elementos individuais da cadeia de entrada especificada. Se introduzir a origem de dados MyList do tipo Campo calculado e configurar para a expressão SPLIT("abc", 1), a expressão INDEX(MyList,2).Value devolve o texto "b".

Exemplo 4

A função ENUMERATE também pode ajudar a aceder a elementos individuais da cadeia de entrada especificada. Se introduzir primeiro a origem de dados MyList do tipo Campo calculado e configurar para a expressão SPLIT("abc", 1) e, em seguida, introduzir a origem de dados EnumeratedList do tipo Campo calculado e configurar para a expressão ENUMERATE(MyList), a expressão FIRSTORNULL(WHERE(EnumeratedList, EnumeratedList.Number=2)).Value devolve o texto "b".

Recursos adicionais

Funções de lista