Função Split

  • Artigo

Aplica-se a: Aplicações de tela Fluxos de ambiente de trabalho Aplicações condicionadas por modelo Power Platform CLI

Divide uma cadeia de texto numa tabela de subcadeias.

Descrição

A função Split divide uma cadeia de texto numa tabela de subcadeias. Utilize a função Split para dividir listas delimitada por vírgulas, datas que colocam uma barra entre os elementos da data e noutras situações em que é utilizado um delimitador bem definido.

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 utilizada com as funções First e Last para extrair uma única subcadeia 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", "," ) ) Idêntico ao exemplo anterior mas, neste caso, o espaço é removido pela função TrimEnds, que atua na tabela de coluna única produzida pela função 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"