Funções Trim e TrimEnds

Aplica-se a: Aplicações de tela Colunas de fórmula do Dataverse Fluxos de ambiente de trabalho Aplicações condicionadas por modelo Power Platform CLI

Removem espaços adicionais de uma cadeia de texto.

Descrição

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

A função TrimEnds remove todos os espaços existentes no início e no fim de uma cadeia de texto, mas mantém os espaços entre as palavras.

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 os espaços existentes entre as palavras, a função Trim é consistente com a função homónima do Microsoft Excel. Contudo, a função TrimEnds é consistente com as ferramentas de programação que só cortam os espaços existentes no início e fim de cada cadeia.

Sintaxe

Trim( Cadeia )
TrimEnds( Cadeia )

  • Cadeia – Obrigatório. A cadeia de texto cujos espaços serão removidos.

Trim( TabelaComUmaÚnicaColuna )
TrimEnds( TabelaComUmaÚnicaColuna )

  • TabelaComUmaÚnicaColuna – 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( " Hello World " ) 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. "Hello World"
TrimEnds( " Hello World " ) Remove todos os espaços existentes no início e no fim de uma cadeia. "Hello World"

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

valor
" Jane Doe "
" Jack and 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 and Jill", "Já cortado", "Vénus, Terra, Marte", "Óleo e Água " ] )

Fórmula Descrição Resultado
Trim( Spaces ) 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( Spaces ) 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.