Histórico da Página
Incluir 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”