SET ALTERNATE
 Envía la salida de consola a un fichero de texto
------------------------------------------------------------------------------
 Sintaxis

     SET ALTERNATE TO [<xcFichero> [ADDITIVE]]
     SET ALTERNATE ON | OFF | <xlConmutar>

 Argumentos

     TO <xcFichero> abre un fichero de texto ASCII estándar para la
     salida con una extensión por defecto de .txt. El nombre de fichero
     puede incluir opcionalmente una extensión, letra de unidad y/o vía.
     Puede especificar <xcFichero> como un nombre de fichero literal o como
     una expresión de caracteres entre paréntesis. Tenga en cuenta que si
     existe otro fichero con el mismo nombre, quedará sobreescrito.

     ADDITIVE hace que el fichero alternativo especificado se amplíe en
     vez de sobreescribirse. Si no se especifica, el fichero alternativo
     indicando se trunca antes de escribirse nueva información en él.

     ON hace que la salida de consola se escriba en el fichero de texto
     abierto.

     OFF interrumpe la escritura de la salida de consola al fichero de
     texto sin cerrarlo.

     <xlConmutar> es una expresión lógica que debe incluirse entre
     paréntesis. El valor verdadero (.T.) equivale a ON (activar)  y el
     valor falso (.F.) a OFF (desactivar).

 Descripción

     SET ALTERNATE es un mandato de consola que le permite escribir la
     salida de los mandatos de consola en un fichero de texto. Los mandatos
     como LIST, REPORT FORM, LABEL FORM y ?, que se muestran en pantalla sin
     referencia a la posición de fila y columna, son mandatos de consola. La
     mayoría de estos mandatos tienen una cláusula TO FILE que lleva a cabo
     la misma función que SET ALTERNATE. La salida de los mandatos de
     pantalla completa, como por ejemplo @...SAY, no pueden escribirse en un
     fichero en disco con SET ALTERNATE. Para lograr el mismo efecto, puede
     utilizar SET PRINTER TO <xcFichero> con SET DEVICE TO PRINTER.

     SET ALTERNATE tiene dos formas básicas. La forma TO <xcFichero> crea un
     fichero de texto DOS con una extensión por defecto .txt y sobreescribe
     cualquier fichero que tenga el mismo nombre. Los ficheros alternativos
     no están relacionados con áreas de trabajo que tienen sólo un fichero
     abierto a la vez. Para cerrar un fichero alternativo, utilice CLOSE
     ALTERNATE, CLOSE ALL o SET ALTERNATE TO sin argumentos.

     La forma ONOFF controla la escritura de la salida de consola en el
     fichero alternativo actual. SET ALTERNATE ON inicia la escritura de la
     salida en el fichero alternativo. SET ALTERNATE OFF interrumpe la
     salida en el fichero alternativo, pero no lo cierra.

 Ejemplos

      Este ejemplo crea un fichero alternativo y escribe los
        resultados del mandato ? en el fichero para cada registro del
        fichero de base de datos Cliente:

        SET ALTERNATE TO FichList
        SET ALTERNATE ON
        USE Cliente NEW
        DO WHILE !EOF()
           ? Cliente->Apellido, Cliente->Ciudad
           SKIP
        ENDDO
        SET ALTERNATE OFF
        CLOSE ALTERNATE
        CLOSE Cliente

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: CLOSE FCREATE() FOPEN() FWRITE() SET CONSOLE