Compartir a través de

_TEXT (Variable del sistema)

  • Artículo

Dirige el resultado de los comandos de combinación de texto \ | \\ y TEXT ... ENDTEXT a un archivo de nivel inferior.

_TEXT = nFileHandle

Parámetros

  • nFileHandle
    Especifica un valor numérico que determina el archivo de nivel inferior al que se dirige el resultado.

Observaciones

\ | \\ y TEXT ... ENDTEXT facilitan la combinación de texto con el contenido de tablas, variables de memoria y con los resultados de funciones y expresiones. El resultado generado por estos comandos de combinación de texto se puede dirigir a la pantalla, a una ventana o a un archivo de nivel inferior. La variable del sistema _TEXT le permite dirigir el resultado de combinar texto desde estos comandos a un archivo de nivel inferior.

Para enviar el resultado desde los comandos de combinación de texto \, \\ y TEXT ... ENDTEXT a un archivo de nivel inferior, incluya la cláusula TO NombreArchivo en SET TEXTMERGE. El controlador de archivo de NombreArchivo se almacena en _TEXT. Si se había almacenado previamente el controlador de archivo de otro archivo de nivel inferior en _TEXT, este archivo de nivel inferior se cierra.

FCREATE( ) crea y abre archivos de nivel inferior y FOPEN( ) abre archivos existentes. Estas funciones devuelven un controlador de archivo positivo si el archivo se ha logrado crear o abrir sin problemas. Al almacenar este controlador de archivo en _TEXT se dirige el resultado posterior desde los comandos de combinación de texto \, \\ y TEXT ... ENDTEXT al archivo. Utilice STORE o = para almacenar un controlador de archivo en _TEXT. Es necesario abrir un archivo de nivel inferior con privilegios de escritura con el fin de que acepte el resultado procedente de los comandos de combinación de texto.

Puede cerrar archivos de nivel inferior con FCLOSE( ) o con CLOSE ALL. También puede utilizar SET TEXTMERGE TO sin ningún nombre de archivo para cerrar el archivo de nivel inferior cuyo controlador está almacenado en _TEXT.

El valor predeterminado inicial de _TEXT es –1. Si desea dirigir el resultado de la combinación de texto a un archivo cuyo controlador de archivo está almacenado en _TEXT, puede desconectar el envío del resultado a dicho archivo sin necesidad de cerrarlo al almacenar –1 en _TEXT. Si almacena distintos controladores de archivo y –1 en _TEXT, puede dirigir el resultado de combinar texto a archivos alternativos.

Ejemplo

El siguiente programa demuestra la forma de dirigir el resultado de la combinación de texto a otros archivos:

SET TALK OFF
SET TEXTMERGE ON NOSHOW      && Enable text merge, no output to screen
SET TEXTMERGE DELIMITERS TO   && Default text merge delimiters <<,>>
SET TEXTMERGE TO date.txt   && Create and send output to date.txt
STORE _TEXT TO gcDateHandle   && Save date.txt's file handle
STORE -1 TO _TEXT         && Output off to date.txt; keep it open
SET TEXTMERGE TO time.txt   && Create and send output to time.txt
STORE _TEXT TO gcTimeHandle   && Save time.txt's file handle

** Send the following text to time.txt ** \The time is: STORE gcDateHandle TO _TEXT && Now direct output to date.txt ** Send the following text to date.txt ** \Today's date is: STORE gcTimeHandle TO _TEXT && Now direct output to time.txt ** Output the time on the same line ** \ <<TIME( )>> STORE gcDateHandle TO _TEXT && Now direct output to date.txt ** Output the date on the same line ** \ <<DATE( )>> CLOSE ALL && Close all files TYPE date.txt && See what's in this file... WAIT WINDOW && Pause TYPE time.txt && ...and what's in this file ERASE date.txt ERASE time.txt

Vea también

\ | \\ | FOPEN( ) | FCLOSE( ) | FCREATE( ) | _PRETEXT | SET TEXTMERGE | SET TEXTMERGE DELIMITERS | Variables del sistema ordenadas alfabéticamente | Introducción a las variables del sistema