Partilhar via


Split Função

Aplica-se a: Aplicativos de tela Copilot Studio Fluxos de ambiente de trabalho Aplicações orientadas por modelos Funções do Power Platform CLI Dataverse Power Pages

Divide uma cadeia de texto numa tabela de subcadeias.

Descrição

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

Uma cadeia de separação é utilizada para dividir a cadeia de texto. O separador pode ser zero, um ou mais carateres que correspondem a um todo na cadeia de texto. A utilização de uma cadeia de comprimento igual a zero ou blank resulta na separação individual de cada caráter. Os carateres de separador correspondentes não são devolvidos nos resultados. Se não for encontrada nenhuma correspondência de separador, toda a cadeia de texto será devolvida como um único resultado.

Utilize a função Concat para voltar a combinar a cadeia sem os separadores.

Utilize a função MatchAll para dividir uma cadeia de carateres utilizando uma expressão regular.

Os exemplos mostram como Split pode ser usado com as funções First e Last para extrair uma única substring delimitada. A função Match é, normalmente, uma opção mais concisa e poderosa para as expressões regulares.

Sintaxe

Split( Texto, Separador )

  • Texto - Obrigatório. Texto a dividir.
  • Separador - Obrigatório. Separador a utilizar para dividir a cadeia. Pode ser zero, um ou mais carateres.

Exemplos

Utilização básica

Fórmula Descrição Resultado
Split( "Apples, Oranges, Bananas", "," ) Divide as diversas frutas, com base no separador de vírgula. A divisão é efetuada apenas com base na vírgula e não no espaço a seguir, resultando num espaço diante 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", "," ) ) O mesmo que o exemplo anterior, mas neste caso o espaço é removido pela função TrimEnds, operando na tabela de coluna única que é produzida por Split. Também poderíamos ter utilizado o separador ", ", que inclui o espaço após a vírgula, mas poderá não funcionar corretamente se não houver nenhum espaço ou se houver 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, utilizando uma barra como separador. Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "08", "28", "17"

Delimitadores diferentes

Fórmula Descrição Resultado
Split( "Hello, World", "," ) Divide as palavras, utilizando uma vírgula como separador. O segundo resultado começa com um espaço, uma vez que este é o caráter imediatamente a seguir à vírgula. Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "Hello", " World"
Split( "Hello, World", "o" ) Divide a cadeia, utilizando o caráter "o" como separador. Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "Hell", ", W", "rld"
Split( "Hello, World", "l" ) Divide a cadeia, utilizando o caráter "I" como separador. Uma vez que não existem carateres entre os dois l de Hello, foi devolvido um valor blank. Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "He", Blank(), "o, Wor", "d"
Split( "Hello, World", "ll" ) Divide a cadeia, utilizando o duplo caráter "lI" como separador. Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "He", "o, World"
Split( "Hello, World", "%" ) Divide a cadeia, utilizando o símbolo de percentagem como separador. Uma vez que este separador não aparece na cadeia, toda a cadeia é devolvida como um resultado. Uma tabela de coluna única com uma coluna Value contendo o seguinte valor: "Hello, World"
Split( "Hello, World", "" ) Divide a cadeia, utilizando uma cadeia vazia como separador (zero carateres). Esta ação divide a cadeia em cada caráter. 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 Descrição Resultado
First( Split( Last( Split( "Bob Jones <bob.jones@contoso.com>", "<" ) ).Result, ">" ) ).Result Divide a cadeia com base num delimitador de abertura (<) e extrai a cadeia de carateres para a direita do delimitador com Last. Em seguida, a fórmula divide o resultado com base no delimitador de fecho (>) e extrai a cadeia à esquerda do delimitador com Right. bob.jones@contoso.com
Match( "Bob Jones <bob.jones@contoso.com>", "<(?<email>.+)>" ).email Efetua a mesma extração baseada em delimitador como o último exemplo, mas utiliza a função Match e uma expressão regular. bob.jones@contoso.com