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”