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( Cadeia de caracteres )
TrimEnds( Cadeia de caracteres )

  • 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:

Para criar essa coleção, defina a propriedade OnSelect de um controle Botão como a esta fórmula, abra o modo de Visualização e clique ou toque no botão:
ClearCollect( Spaces, [ "   Jane   Doe   ", "    Jack   e   Jill", "Já aparado", "   Vênus,   Terra,   Marte  ", "Óleo e Água   " ] )

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.
TrimEnds( Spaces ) Remove todos os espaços do início e do final de cada cadeia de caracteres da coleção Spaces.

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.