Compartilhar via


Função de ER SPLIT

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

Sintaxe 1

SPLIT (input, length)

Esta sintaxe é usada para dividir a cadeia de caracteres de entrada especificada em subcadeias de caracteres, cada uma com o tamanho especificado.

Sintaxe 2

SPLIT (input, delimiter)

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

Argumentos

input: Cadeia de caracteres

O texto a ser dividido.

length: Inteiro

O tamanho máximo de uma única subcadeia de caracteres.

delimiter: Cadeia de caracteres

Um delimitador usado para separar as subcadeias de caracteres.

Valores de retorno

Lista de registros

A lista de registros resultante.

Notas de uso

A estrutura de registro da lista retornada consiste no campo Valor do tipo Cadeia de caracteres. Todos os registros da lista retornada contêm subcadeias de caracteres geradas nesse campo.

Se o argumento delimiter estiver vazio, a nova lista retornada consistirá em um registro com o campo Valor do tipo Cadeia de caracteres. Esse campo contém o texto de entrada.

Se o argumento input estiver vazio, uma nova lista vazia será retornada. Se o argumento input ou delimiter não estiver especificado (nulo), uma exceção de aplicativo será gerada.

Exemplo 1

SPLIT ("abcd", 3) retorna uma nova lista que consiste em dois registros com o campo Valor do tipo Cadeia de caracteres. O campo Valor no primeiro registro contém o texto "abc" e o campo Valor no segundo registro contém o texto “d”.

Exemplo 2

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

Exemplo 3

Você pode usar a função INDEX para acessar elementos individuais da cadeia de caracteres de entrada especificada. Se você inserir a fonte de dados MyList do tipo Campo calculado e configurar a expressão SPLIT("abc", 1) para ela, a expressão INDEX(MyList,2).Value retornará o valor de texto "b".

Exemplo 4

A função ENUMERATE também ajuda a acessar elementos individuais da cadeia de caracteres de entrada especificada. Se você inserir primeiro a fonte de dados MyList do tipo Campo calculado e configurá-la para a expressão SPLIT("abc", 1) e, em seguida, inserir a fonte de dados EnumeratedList do tipo Campo calculado e configurar a expressão ENUMERATE(MyList) para ela, a expressão FIRSTORNULL(WHERE(EnumeratedList, EnumeratedList.Number=2)).Value retornará o texto "b".

Recursos adicionais

Funções de listagem