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".