Compartilhar via


Trim e TrimEnds funções

Aplica-se a: Aplicativos de tela O Copilot Studio Desktop flui colunas de fórmula do Dataverse para aplicativos controlados por modelos do Power Platform CLI Dataverse functions Power Pages

Remove espaços extras de uma cadeia de texto.

Descrição

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

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

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 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 somente desde o início e o 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:

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
Trim( 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.