TOTVSTEC

Árvore de páginas

Remove os espaços em branco à direita e à esquerda de uma string.

Sintaxe

AllTrim( < cText > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cText

qualquer

Indica o texto cujos espaços em branco serão removidos.

X

 

Retorno

Nome

Tipo

Descrição

cRet

caractere

Retorna uma string com espaços em branco à direita e à esquerda removidos.

Observações

  • Caso cText não seja do tipo caracter, a função retornará uma string vazia ("").
  • AllTrim está relacionada as funções LTrim, que remove os espaços em branco à esquerda, e a RTrim, que remove os espaços em branco à direita.
  • O inverso de AllTrim, RTrim e LTrim são as funções PadC, PadR e PadL, que centralizam, alinham à direita ou à esquerda as strings, respectivamente, através da inserção de caracteres de preenchimento.

Exemplos

Exemplo 1
#define CRLF Chr(13) + Chr(10)
//+----------------------------------------------------------------------------+
//|Exemplo de uso da função AllTrim                                            |
//+----------------------------------------------------------------------------+
User Function atrim1()
  Local cText  := "    text with spaces at the beginning and at the end    "
  Local cAllTrim := AllTrim( cText )
  Local cMensagem := ""
  
  cMensagem := "Original Text: [" + cText + "]"
  cMensagem += CRLF + "AllTrim: " + CRLF + "[" + cAllTrim + "]"
Return MsgInfo( cMensagem, "AllTrim Example" )

Resultado do Exemplo

Abrangência

Todas as versões

Veja também

  • Sem rótulos