prevnext   » Startseite » Haupt-Referenz » Kommando-Referenz » #CATCH

#CATCH

Die Ausgabe in eine Zeichenkette umleiten.

Syntax:

#CATCH [max_size]

Parameter:

max_size Ein 32-Bit Ganzzahl, die die maximale Anzahl der Zeichen, die gespeichert werden, angibt.

Ohne Angabe und bei Werten <0 wird die Voreinstellung 1 MB (106 Bytes) verwendet. Die Größe ist nach oben auf 1 GB (109 Bytes) begrenzt.

Beschreibung:

Dieses Kommando existiert nur unter MakeDoc.

Ab diesem Kommando werden die direkten Ausgaben und die Ausgaben mittels #PRINT nicht mehr in die Ausgabedatei geschrieben, sondern intern gepeichert. Hinter jeder Ausgabe wird automatisch ein LF eingefügt.

Alle Ausgabezeilen werden eingesammelt. Dabei haben die Kommandos #START, #STOP und #EMPTYLINES keinerlei Einfluss auf das Einsammeln.

Die Ausgabedaten werden solange gespeichert, bis ein korrespondierendes #ENDCATCH gefunden wird. Dieses #ENDCATCH speichert die Ausgabe dann in einer Variable mit dem Typ STRING.

Es ist eine Verschachtlungstiefe von maximal 100 möglich. Bei Neubeginn und beim Verlassen einer Schleife werden alle in der Schleife aktivierten Catch-Kommandos automatisch wieder geschlossen, so dass die Catch-Hierarchie, die bei Eintritt in die Schleife bestand, wieder hergestellt wird.

Die Ausgabeumleitung mittels #TEXTMACRO hat Vorrang vor der von #CATCH/#CATCHLIST.

Siehe auch:
 #CATCHLIST   #ENDCATCH   #TEXTMACRO 

Weitere ähnliche Kommandos:

Ausgabe und Fehlermeldungen
Kommando Kurzinfo
#$
#CATCH Die Ausgabe in eine Zeichenkette umleiten.
#CATCHLIST Die Ausgabe in eine Liste von Zeichenketten umleiten.
#DEBUG
#ECHO Ausgabe eines Textes auf den Fehlerkanal und in die Log-Datei.
#ECHOLOG Ausgabe eines Textes in die Log-Datei.
#ENDCATCH Die Ausgabeumleitung in eine Zeichenkette beenden.
#ERROR Ausgabe eines Textes als Fehlermeldng mit automatischer Angabe der Referenzzeile auf den Fehlerkanal und in die Log-Datei. Das Programm wird nach der Meldung beendet.
#FLUSHALL Den Inhalt der Ausgabe-Puffer aller Streams leeren (rausschreiben).
#LANGUAGE
#MESSAGE Ausgabe eines Textes mit automatischer Angabe der Referenzzeile auf den Fehlerkanal und in die Log-Datei.
#OUTPUT
#PRINT
#SOURCE
#VERBOSE
#WARNING Ausgabe eines Textes als Warnung mit automatischer Angabe der Referenzzeile auf den Fehlerkanal und in die Log-Datei.
#WRITE