Função Split

Aplica-se a: Aplicativos Canvas Fluxos de desktop Aplicativos orientados a modelos Power Pages Power Platform CLI

Divide uma cadeia de texto em uma tabela de subcadeias.

Description

A função Split divide uma cadeia de texto em uma tabela de subcadeias. Use Split para dividir listas delimitadas por vírgula, datas que usam uma barra entre as partes da data e em outras situações em que um delimitador bem definido é usado.

Uma cadeia de caracteres de separador é usada para dividir a cadeia de texto. O separador pode ser zero, um ou mais caracteres combinados como um todo na cadeia de texto. O uso de uma cadeia de comprimento zero ou em branco resultará em cada caractere sendo dividido individualmente. Os caracteres separadores correspondentes não serão retornados no resultado. Se nenhuma correspondência de separador for encontrada, a cadeia de texto inteira será retornada como um único resultado.

Use a função Concat para recombinar a cadeia de caracteres sem os separadores.

Use a função MatchAll para dividir uma cadeia de caracteres usando uma expressão regular.

Os exemplos mostram como a Split pode ser usada com as funções First e Last para extrair uma única subcadeia de caracteres delimitada. A função Corresponder é geralmente uma opção mais concisa e poderosa para expressões regulares.

Sintaxe

Divisão( Texto, Separador )

• Texto - Obrigatório. Texto a ser dividido.
• Separador - Obrigatório. Separador a ser usado na divisão da cadeia de caracteres. Pode ser zero, um ou mais caracteres.

Exemplos

Uso básico

Fórmula	Descrição	Resultado
Split( "Apples, Oranges, Bananas", "," )	Divide as diferentes frutas com base no separador de vírgula. A divisão é realizada somente com base na vírgula e não no espaço depois dela, resultando em um espaço na frente de "laranjas" e "bananas".	Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "Maçãs", "Laranjas", "Bananas"
TrimEnds( Split( "Apples, Oranges, Bananas", "," ) )	Igual ao exemplo anterior, mas, nesse caso, o espaço será removido pela função TrimEnds, que opera na tabela de coluna única produzida pela função Split. Poderíamos também ter usado o separador ", " que inclui o espaço após a vírgula, mas isso não funcionaria corretamente se não houvesse nenhum espaço ou se houvesse dois espaços.	Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "Maçãs", "Laranjas", "Bananas"
Split( "08/28/17", "/" )	Divide a data, usando uma barra "/" como separador.	Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "08", "28", "17"

Diferentes delimitadores

Fórmula	Description	Result
Split( "Hello, World", "," )	Divide as palavras, usando uma vírgula como separador. O segundo resultado começa com um espaço, pois é o caractere imediatamente após a vírgula.	Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "Hello", " World"
Split( "Hello, World", "o" )	Divide a cadeia de caracteres, usando o caractere "o" como o separador.	Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "Hell", ", W", "rld"
Split( "Hello, World", "l" )	Divide a cadeia de caracteres, usando o caractere único "l" como o separador. Como não havia nenhum caractere entre os dois ls em Hello, um valor em branco foi retornado.	Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "He", em branco (), "o, Wor", "d"
Split( "Hello, World", "ll" )	Divide a cadeia de caracteres, usando o caractere duplo "ll" como o separador.	Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "He", "o, World"
Split( "Hello, World", "%" )	Divide a cadeia de caracteres, usando o sinal de porcentagem como separador. Como esse separador não aparece na cadeia de caracteres, a cadeia de caracteres inteira é retornada como o resultado.	Uma tabela de coluna única com uma coluna Value contendo o seguinte valores: "Hello, World"
Split( "Hello, World", "" )	Divide a cadeia de caracteres, usando uma cadeia de caracteres vazia como o separador (nenhum caractere). Isso dividirá a cadeia de caracteres em cada caractere.	Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "H", "e", "l", "l", "o", ",", " ", "W", "o", "r", "l", "d"

Extração de subcadeias

Fórmula	Description	Result
First( Split( Last( Split( "Bob Jones <bob.jones@contoso.com>", "<" ) ).Result, ">" ) ).Result	Divide a cadeia de caracteres com base em um delimitador de abertura (<) e extrai a cadeia de caracteres à direita do delimitador com o Last. Em seguida, a fórmula divide esse resultado com base no delimitador de fechamento (>) e extrai a cadeia de caracteres à esquerda do delimitador com Right.	"bob.jones@contoso.com"
Match( "Bob Jones <bob.jones@contoso.com>", "<(?<email>.+)>" ).email	Executa a mesma extração baseada em delimitador como o último exemplo, mas usa a função Match e uma expressão regular em vez disso.	"bob.jones@contoso.com"