Histórico da Página

Sintaxe

RTRIM( <expressão caracter> )

Propósito

Remove os espaços em branco à direita de uma cadeia de caracteres.

Argumentos

<expressão caracter>

Define a cadeia de caracteres cujos espaços em branco à direita serão removidos.

Utilização

A função RTRIM(), ou apenas TRIM(), é utilizada para remover os espaços em branco à direita de uma cadeia de caracteres, quando se necessita de uma adequada formatação dos dados. Por exemplo, quando o comprimento real do dado contido na variável ou no campo for menor do que o previsto originalmente.

Essa função também é muito útil quando se necessita concatenar duas ou mais cadeias de caracteres e não se deseja incluir os espaços em branco restantes entre elas.

Se a cadeia de caracteres especificada for nula (“”) ou se contiver apenas espaços em branco, a função RTRIM() fornecerá uma cadeia de caracteres nula (“”).

Dicas

Uma aplicação típica da função RTRIM é a formatação de nomes e endereços em etiquetas de endereçamento para, por exemplo, eliminar os espaços em branco entre o nome da cidade e a sigla do estado: RTRIM(cCidade) + “ – “ + cEstado.

A função RTRIM() está relacionada com as funções LTRIM(), que remove os espaços em branco da esquerda, e ALLTRIM(), que remove tanto os espaços em branco da direita como os da esquerda.

As funções PADL(), PADR() e PADC() são, respectivamente, o inverso das funções LTRIM(), RTRIM() e ALLTRIM(). Estas funções adicionam caracteres, em geral espaços em branco, alinhando cadeias de caracteres à esquerda, à direita e de ambos os lados (centralizando-as), respectivamente. Com estas quatro funções é possível obter qualquer formatação desejada numa cadeia de caracteres.

Exemplos

cNome := “Protheus – O ERP da TOTVS          ”

MsgAlert( RTRIM(cNome) )     // Resulta “Protheus – O ERP da TOTVS”

cNome := “          Protheus – O ERP da TOTVS          ”

MsgAlert( RTRIM(cNome) )     // Resulta “          Protheus – O ERP da TOTVS”