Funções Trim e TrimEnds

Aplica-se a: Aplicativos de tela Colunas de fórmula do Dataverse Fluxos da área de trabalho Aplicativos baseados em modelo Power Platform CLI

Remove espaços extras de uma cadeia de texto.

Descrição

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

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

Se você especificar uma única cadeia de texto, o valor de retorno da função será a cadeia de caracteres com espaços extras removidos. Se você especificar uma tabela de coluna única que contenha cadeias de caracteres, o valor de retorno será uma tabela de coluna única com cadeias de caracteres aparadas. Se você tiver uma tabela de várias colunas, é possível formatá-la como uma tabela de coluna única, como descrito em Trabalhando com tabelas.

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

Sintaxe

Trim( String )
TrimEnds( String )

  • String - obrigatório. A cadeia de texto da qual os espaços serão removidos.

Trim( SingleColumnTable )
TrimEnds( SingleColumnTable )

  • SingleColumnTable - obrigatório. Uma tabela de coluna única com cadeias de caracteres das quais os espaços serão removidos.

Exemplo

Fórmula Descrição Resultado
Trim( " Olá, Mundo " ) Remove todos os espaços do início e do final de uma cadeia de caracteres, e os espaços extras de dentro da cadeia de caracteres. "Olá, Mundo"
TrimEnds( " Olá, Mundo " ) Remove todos os espaços do início e do final de uma cadeia de caracteres. "Olá, Mundo"

Os exemplos a seguir usam uma coleção de coluna única, chamada Espaços, que contém estas cadeias de caracteres:

Valor
" Jane Doe "
" Jack e Jill"
"Já aparado"
" Vênus, Terra, Marte "
" Óleo e Água "

Para criar essa coleção, defina a propriedade OnSelect de um controle Button como a esta fórmula, abra o modo de Visualização e clique ou toque no botão:
ClearCollect( Spaces, [ " Jane Doe ", " Jack and Jill", "Already trimmed", " Venus, Earth, Mars ", "Oil and Water " ] )

Fórmula Descrição Resultado
Trim( Spaces ) Remove todos os espaços do início e do final de uma cadeia de caracteres, e os espaços extras de dentro da cadeia de caracteres Spaces. Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "Jane Doe", "Jack e Jill", "Já aparado", "Vênus, Terra, Marte", "Óleo e Água"
TrimEnds( Spaces ) Remove todos os espaços do início e do final de cada cadeia de caracteres da coleção Spaces. Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: "Jane Doe", "Jack e Jill", "Já aparado", "Vênus, Terra, Marte", "Óleo e Água"

Observação

Os espaços extras não aparecerão se você exibir uma coleção clicando ou tocando em Coleções no menu Arquivo. Para verificar o comprimento da cadeia de caracteres, use a função Len.