RTRIM()
 Suprime los espacios finales de una cadena de caracteres
------------------------------------------------------------------------------
 Sintaxis

     RTRIM(<cCadena>) --> cCadenaSuprim

 Argumentos

     <cCadena> es la cadena de caracteres que se va a copiar sin
     espacios finales.

 Devuelve

     RTRIM() devuelve una copia de <cCadena> sin espacios finales. Si
     <cCadena> es una cadena nula ("") o todo espacios, RTRIM() devuelve una
     cadena nula ("").

 Descripción

     RTRIM() es una función de caracteres que formatea cadenas de
     caracteres. Sirve para borrar espacios finales al concatenar cadenas,
     lo que ocurre con mucha frecuencia en los campos de base de datos que
     se almacenan con un formato de anchura fija. Por ejemplo, RTRIM() puede
     utilizarse para concatenar los campos que contienen el nombre y el
     apellido para formar una cadena con el nombre completo.

     RTRIM() está relacionada con LTRIM(), que suprime los espacios
     iniciales, y con ALLTRIM(), que suprime tanto los espacios iniciales
     como los finales. Las funciones inversas de ALLTRIM(), LTRIM() y
     RTRIM() son PADC(), PADR() y PADL(), que centran, justifican a la
     derecha o justifican a la izquierda, respectivamente, las cadenas de
     caracteres, rellenándolas con caracteres de relleno. RTRIM() es
     parecida a la función TRIM().

 Notas

     ■ Caracteres de espacio:  La función RTRIM() trata los retornos
        de carro, los saltos de línea y los tabuladores como si fueran
        espacios en blanco y, por consiguiente, también los suprime de la
        cadena de caracteres.

 Ejemplos

      Esta es una función en la que RTRIM() formatea los campos
        Ciudad, Provincia y Código postal para etiquetas y circulares:

        FUNCTION Direccion(cCiudad, cProvincia, cCodigoPostal)
           RETURN RTRIM(cCiudad) + ", " ;
            + RTRIM(cProvincia) + " " + cCodigoPostal

      En este ejemplo, la función Direccion() muestra un registro de
        Clientes.dbf:

        USE Clientes INDEX NombreCli NEW
        SEEK "Rosa"
        ? Direccion(Ciudad, Provincia, CodigoPostal)
        // Resultado: Oviedo, Asturias 43066

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: PAD() SUBSTR() TRIM()