export_def
— Fügt beliebigen Text in den Codeexport ein.
export_def( : : Position, Declaration : )
export_def
erlaubt es, beliebige Texte beim Export von Programmen
oder Prozeduren in die Ausgabedatei einzufügen.
Der Parameter Position
steuert, wo der Text, der in
Declaration
gesetzt wird, in die Exportdatei eingefügt werden soll.
Dabei werden die folgenden Optionen unterstützt:
Der Text wird an der gleichen Stelle in die exportierte Prozedur eingefügt, an der er auch im HDevelop-Code steht.
Der Text wird ganz am Anfang der exportierten Datei eingefügt.
Der Text wird unmittelbar vor der Prozedur, in der der export_def
Befehl steht, in die exportierte Datei eingefügt.
Der Text wird unmittelbar nach der Prozedur, in der der export_def
Befehl steht, in die exportierte Datei eingefügt.
Der Text wird ganz am Ende der exportierten Datei eingefügt.
Im Programmlisting wird der Befehl export_def
nicht in der normalen Operatorschreibweise ausgegeben, sondern durch eine
spezielle Zeichenfolge eingeleitet.
Das erste Zeichen ist das Exportzeichen #
, das entsprechend obiger
Auflistung von einer Positionskennung gefolgt werden kann.
Soll ein export_def
Befehl im Freitexteditor eingegeben werden, ist
zu beachten, dass vor dem Exportzeichen #
kein Leerzeichen stehen
darf.
Um die Lesbarkeit zu verbessern kann zwischen der Exportkennzeichnung und dem zu exportierenden Text ein Leerzeichen stehen, das nicht mit exportiert wird. Zusätzliche Leerzeichen werden dagegen mit exportiert.
Texte, die innerhalb der aktuellen Prozedur ausgegeben werden, werden
entsprechend der aktuellen Einrücktiefe eingerückt.
Dabei gibt es eine Ausnahme: Fängt der zu exportierende Text mit #
an, wird der Text nicht eingerückt:
for Index := 1 to 5 by 1 # #ifdef MY_SWITCH # int cnt = 100; * ein optionaler Codeblock # #endif endfor
Wird exportiert zu:
proc (...) { ... for (...) { #ifdef MY_SWITCH int cnt = 100; // ein optionaler Codeblock #endif } ... }
Der Befehl export_def
kann wie jeder normale Operator aktiviert
oder deaktiviert werden.
Deaktivierte Exportbefehle werden nicht exportiert.
Position
(input_control) string →
(string)
Position, an der Exporttext in die Ausgabedatei eingefügt werden soll.
Werteliste: 'after_procedure' , 'at_file_begin' , 'at_file_end' , 'before_procedure' , 'in_place'
Declaration
(input_control) string →
(string)
Zu exportierender Text.
export_def
wird nicht ausgeführt.
Foundation