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

     TRIM(<cCadena>) --> cCadenaSuprim

 Argumentos

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

 Devuelve

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

 Descripción

     TRIM() 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, TRIM() puede
     utilizarse para concatenar los campos que contienen el nombre y el
     apellido para formar una cadena con el nombre completo.

     TRIM() 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 a la izquierda, respectivamente, las cadenas de caracteres,
     completándolas con caracteres de relleno.

 Notas

     ■ Caracteres de espacio:  La función TRIM() 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 TRIM() formatea los campos
        Ciudad, Provincia y Código postal para incluirlos en etiquetas y cartas:

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

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

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

 Ficheros   La biblioteca asociada es CLIPPER.LIB.
 To download this example - click here.

See Also: PAD() RTRIM() SUBSTR()