RTRIM()

Sintaxis

RTRIM( <expresión carácter> )

Propósito

Borra los espacios en blanco ubicados a la derecha de una cadena de caracteres.

Argumentos

<expresión carácter>

Define la cadena de caracteres cuyos espacios en blanco se borrarán.

Utilización

La función RTRIM(), o simplemente TRIM(), se utiliza para borrar los espacios en blanco ubicados a la derecha de una cadena de caracteres, cuando es necesario formatear los datos adecuadamente. Por ejemplo, cuando la longitud real del dato contenido en la variable o en el campo es inferior al previsto originalmente.

Esta función también es muy útil cuando se necesita concatenar dos o más cadenas de caracteres y no se desea incluir los espacios en blanco restantes.

Si la cadena de caracteres especificada es nula (“”) o si contiene solamente espacios en blanco, la función RTRIM() suministrará una cadena de caracteres nula (“”).

Sugerencias

Una aplicación típica de la función RTRIM es el formateo de nombres y direcciones en etiquetas de direccionamiento, por ejemplo, para borrar los espacios en blanco entre el nombre de la ciudad y la sigla del estado: RTRIM(cCidade) + “ – “ + cEstado.

La función RTRIM() está relacionada con las funciones LTRIM(), que borra los espacios en blanco ubicados a la izquierda, y ALLTRIM(), que borra tanto los espacios en blanco de la derecha como los de la izquierda.

Las funciones PADL(), PADR() y PADC() son, respectivamente, el inverso de las funciones LTRIM(), RTRIM() y ALLTRIM(). Estas funciones agregan caracteres, en general espacios en blanco, alineando cadenas de caracteres ubicados a la izquierda, a la derecha y a ambos lados (centralizándolas), respectivamente. Con estas cuatro funciones es posible obtener cualquier formato deseado en una cadena de caracteres.

Ejemplos

cNome := “Protheus – El ERP de TOTVS          ”

MsgAlert( RTRIM(cNome) )     // Resulta “Protheus – El ERP de TOTVS”

cNome := “          Protheus – El ERP de TOTVS          ”

MsgAlert( RTRIM(cNome) )     // Resulta “          Protheus – El ERP de TOTVS”