Partilhar via


Trim e TrimEnds funções

Aplica-se a: Aplicativos do Canvas Fluxos do Copilot Studio Desktop Colunas de fórmulas Dataverse Aplicações orientadas por modelos CLI da Power Platform Funções Dataverse Páginas de energia

Removem espaços adicionais de uma cadeia de texto.

Descrição

A Trim função remove todos os espaços de uma cadeia de texto, exceto espaços únicos entre palavras.

A TrimEnds função remove todos os espaços do início e do fim de uma cadeia de texto, mas deixa os espaços entre as palavras intactos.

Se especificar apenas uma cadeia de texto, o valor devolvido por estas funções é a cadeia com os espaços adicionais removidos. Se especificar uma tabela com uma única coluna que contém cadeias, o valor devolvido é uma tabela com uma única coluna composta por cadeias cortadas. Se tiver uma tabela com várias colunas, pode formatá-las para uma tabela com uma única coluna, conforme descrito em trabalhar com tabelas.

Ao cortar espaços entre palavras, Trim é consistente com a função de mesmo nome no Microsoft Excel. No entanto, TrimEnds é consistente com ferramentas de programação que cortam espaços apenas do início e do fim de cada cadeia de caracteres.

Sintaxe

Trim( String )
TrimEnds( String )

  • string - obrigatório. A cadeia de texto cujos espaços serão removidos.

Trim( SingleColumnTable )
TrimEnds( SingleColumnTable )

  • SingleColumnTable - Obrigatório. Trata-se de uma tabela com uma única coluna de cadeias cujos espaços serão removidos.

Exemplo

Fórmula Descrição Resultado
Trim( " Olá Mundo " ) Remove todos os espaços existentes no início e no fim de uma cadeia, bem como os espaços adicionais que se encontram dentro da cadeia. "Olá Mundo"
TrimEnds( " Olá Mundo " ) Remove todos os espaços existentes no início e no fim de uma cadeia. "Olá Mundo"

Os exemplos abaixo utilizam uma coleção com uma única coluna designada Espaços, que contém as seguintes cadeias:

Valor
" Jane Doe "
"Jack e Jill"
"Já cortado"
" Vénus, Terra, Marte "
"Petróleo e Água "

Para criar esta coleção, defina a propriedade OnSelect de um controlo Button para esta fórmula, abra o modo de Pré-visualização e, em seguida, clique ou toque no botão:
ClearCollect( Espaços, [ " Jane Doe ", " Jack e Jill", "Já aparado", " Vênus, Terra, Marte ", "Petróleo e Água" ] )

Fórmula Descrição Resultado
Trim( Espaços ) Corta todos os espaços existentes no início e no fim de cada cadeia, bem como os espaços adicionais que se encontram dentro de cada cadeia da coleção Espaços. Uma tabela de coluna única com uma coluna Value com os seguintes valores: "Jane Doe", "Jack and Jill", "Já cortado", "Vénus, Terra, Marte", "Petróleo e Água"
TrimEnds( Espaços ) Corta todos os espaços existentes no início e no fim de cada cadeia da coleção Espaços. Uma tabela de coluna única com uma coluna Value com os seguintes valores: "Jane Doe", "Jack and Jill", "Já cortado", "Vénus, Terra, Marte", "Petróleo e Água"

Nota

Os espaços adicionais não aparecem se clicar ou tocar em Coleções no menu Ficheiro para apresentar uma coleção. Para verificar o comprimento da cadeira, utilize a função Len.