Share via

_TEXT-Systemvariable

  • Artikel

Leitet die Ausgabe von \ | \\ und TEXT ... ENDTEXT-Textzusammenführungsbefehlen in eine Low-Level-Datei um.

_TEXT = nFileHandle

Parameter

  • nFileHandle
    Gibt einen numerischen Wert an, über den die Low-Level-Datei festgelegt wird, in die die Ausgabe umgeleitet werden soll.

Hinweise

\ | \\ und TEXT ... ENDTEXT erleichtern das Zusammenfügen von Text mit den Inhalten von Tabellen, Speichervariablen und den Ergebnissen von Funktionen und Ausdrücken. Die über die Befehle zum Zusammenführen von Text und Daten erzeugte Ausgabe kann auf den Bildschirm, in ein Fenster oder in eine Low-Level-Datei umgeleitet werden. Die _TEXT-Systemvariable ermöglicht Ihnen das Umleiten der Ausgabe dieser Befehle in eine Low-Level-Datei.

Möchten Sie die Ausgabe der TEXTMERGE-Befehle \ und \\ und TEXT ... ENDTEXT in eine Low-Level-Datei umleiten, müssen Sie die Klausel TO FileName in SET TEXTMERGE verwenden. Das Dateihandle von FileName wird in _TEXT gespeichert. War zuvor das Dateihandle einer anderen Low-Level-Datei in _TEXT gespeichert, wird diese Datei geschlossen.

FCREATE( ) erzeugt und öffnet Low-Level-Dateien, und FOPEN( ) öffnet bereits vorhandene Dateien. Diese Funktionen geben ein positives Dateihandle zurück, wenn die Datei erfolgreich erstellt oder geöffnet wurde. Wird dieses Dateihandle in _TEXT gespeichert, werden alle nachfolgenden Ausgaben der Befehle \, \\ und TEXT ... ENDTEXT in die Datei umgeleitet. Verwenden Sie STORE oder =, um das Dateihandle in _TEXT zu speichern. Sie müssen eine Low-Level-Datei mit Schreibrechten öffnen, damit diese die Ausgaben der Befehle zum Zusammenführen von Text und Daten entgegennimmt.

Sie können Low-Level-Dateien mit FCLOSE( ) oder CLOSE ALL schließen. Sie können auch SET TEXTMERGE TO ohne Dateinamen verwenden, um die Low-Level-Datei zu schließen, deren Dateihandle in _TEXT gespeichert ist.

Der Standardanfangswert von _TEXT ist -1. Wenn Sie die Textausgabe in eine Datei umlenken, deren Dateihandle in _TEXT gespeichert ist, können Sie die Ausgabe in diese Datei ausschalten, ohne die Datei zu schließen. Sie können die Textausgabe in alternative Dateien umlenken, indem Sie in _TEXT andere Dateihandles und -1 abspeichern.

Beispiel

Das folgende Beispiel zeigt, wie TEXTMERGE-Ausgaben an alternative Dateien ausgegeben werden:

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

Siehe auch

\ | \\ | FOPEN( ) | FCLOSE( ) | FCREATE( ) | _PRETEXT | SET TEXTMERGE | SET TEXTMERGE DELIMITERS | Systemvariablen A-Z | Systemvariablen - Überblick