TRANSFORM()
 Convierte cualquier valor en una cadena de caracteres formateada
------------------------------------------------------------------------------
 Sintaxis

     TRANSFORM(<exp>, <cPatrónFormatoSay>) --> cCadenaFormato

 Argumentos

     <exp> es el valor que se va a formatear. Puede ser una expresión de
     cualquier tipo de datos válido en CA-Clipper, excepto matrices, bloques
     de código y NIL.

     <cPatrónFormatoSay> es una cadena de máscara y caracteres de
     plantilla que describe el formato de la cadena de caracteres que va a
     devolver la función.

 Devuelve

     TRANSFORM() convierte <exp> en una cadena de caracteres formateada
     según lo definido en <cPatrónFormatoSay>.

 Descripción

     TRANSFORM() es una función de conversión que formatea valores de tipo
     carácter, fecha, lógico y numérico de acuerdo a una cadena de formato
     especificada compuesta por una combinación de funciones de formato y
     caracteres de plantilla. TRANSFORM() formatea datos para su salida por
     pantalla o por impresora de la misma manera que la cláusula PICTURE del
     mandato @...SAY.

     ■ Cadena de función: Una cadena  de función de máscara que
        especifica las reglas de formato aplicadas al valor devuelto por
        TRANSFORM() como un todo, en vez de como posiciones de carácter
        individuales en <exp>. Está formada por el carácter @ seguido de uno
        o más caracteres adicionales, cada uno de los cuales tiene un
        significado determinado (consulte la tabla siguiente). Si se indica
        una cadena de función, el carácter @ debe ser el primero a la
        izquierda de la cadena de máscara, y la cadena de función no debe
        contener espacios. Puede especificarse una cadena de función sola o
        acompañada de una cadena de plantilla. Si se utilizan ambas, la
        cadena de función debe preceder a la cadena de plantilla y deben
        estar separadas por un espacio.

        Funciones TRANSFORM()
        ---------------------------------------------------------------------
        Función        Acción
        ---------------------------------------------------------------------
        B              Muestra números justificados a la izquierda
        C              Muestra CR después de los números positivos
        D              Muestra fechas en el formato especificado por SET DATE
        E              Muestra fechas en formato europeo
        R              Inserta caracteres que no aparecen en la plantilla
        X              Muestra DB después de los números negativos
        Z              Muestra los ceros como espacios en blanco
        (              Sitúa los números negativos entre paréntesis
        !              Convierte en mayúsculas los caracteres alfabéticos
        ---------------------------------------------------------------------

     ■ Cadena de plantilla: Una cadena de plantilla de máscara
        especifica las reglas de formato carácter a carácter. La cadena de
        plantilla está formada por una serie de caracteres, algunos de los
        cuales tienen significados especiales (consulte la tabla siguiente).
        Cada posición de la cadena de plantilla corresponde a una posición
        en el valor del argumento <exp>. Esta plantilla se utiliza con
        TRANSFORM(), por lo que puede servir para insertar caracteres tales
        como comas, signos monetarios y paréntesis.

        Los caracteres de la cadena de plantilla que no tengan significados
        asignados se copian literalmente en el valor devuelto. Si se utiliza
        la función de máscara @R, estos caracteres se insertan entre los
        caracteres del valor devuelto; en caso contrario sustituyen a los
        caracteres correspondientes de dicho valor. Puede especificarse una
        cadena de plantilla sola o acompañada de una cadena de función. Si
        se utilizan ambas, la cadena de función debe ir antes que la cadena
        de plantilla y deben estar separadas por un espacio.

        Plantillas TRANSFORM()
        ---------------------------------------------------------------------
        Plantilla      Acción
        ---------------------------------------------------------------------
        A,N,X,9,#      Muestra dígitos de cualquier tipo de datos
        L              Muestra valores lógicos como "T" o "F"
        Y              Muestra valores lógicos como "Y" o "N"
        !              Convierte en mayúsculas un carácter alfabético
        $              Muestra un signo de dólar en cada espacio
                       inicial en blanco de un valor numérico
        *              Muestra un asterisco en cada espacio inicial
                       en blanco de un valor numérico
        .              Especifica una posición de separador decimal
        ,              Especifica una posición de separador de miles
        ---------------------------------------------------------------------

 Ejemplos

      Este ejemplo asigna un formato monetario a un número
        utilizando una plantilla:

        ? TRANSFORM(123456, "$999,999")         // Resultado: $123,456

      Este ejemplo formatea una cadena de caracteres utilizando una
        función:

        ? TRANSFORM("en mayusculas", "@!")      // Resultado: EN
                                                // MAYUSCULAS

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

See Also: @...SAY PAD() STR() UPPER()