Split Função

Aplica-se a: Aplicativos de tela Copilot Studio Desktop flui aplicativos baseados em modelo CLI CLI Dataverse funções Power Pages

Divide uma cadeia de texto em uma tabela de subcadeias.

Description

A Split função divide uma cadeia de caracteres de texto em uma tabela de subcadeias de caracteres. Use Split para dividir listas delimitadas por vírgulas, datas que usam uma barra entre partes de 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 Split pode ser usado 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

Split( 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	Description	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 é removido pela função TrimEnds, operando na tabela de coluna única que é produzida por 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	Resultado
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	Resultado
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