Compartilhar via

Funções Trim e TrimEnds

  • Artigo

Aplica-se a: Aplicativos Canvas Dataverse Colunas de fórmula Fluxos de desktop Aplicativos baseados em modelo Power Pages 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

Cortar( String )
TrimEnds( String )

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

Aparar( Tabela de coluna única )
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( Espaços, [ " Jane Doe ", " Jack and Jill ", " Já aparado ", " Vênus, Terra, Marte ", " Óleo e Água " ] )

Fórmula Descrição Resultado
Aparar(Espaços) 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(Espaços) 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.