Name
string

Syntax
string

Aufklappen Erläuterung
String Ausdrücke sind Ausdrücke, die Texte als Ergebnisse liefern. Da es nur einen Operator für strings gibt ("+") sind die "Eingangswerte" der Operation oder der Typ der Funktion ausschlaggebend für den Ergebnistyp. Der Ergebnistyp ist i.d.R. eindeutig, kann aber mit der Funktion VARTYPE() geprüft werden.

Aufklappen Beispiel
Explizite Werte ("Klartext"):
"Klartext"
'Textbegrenzer'


Platzhalter:
beschreibung
name[4]
beschriftung[2][i]


Verknüpfung von Texten mit "+"-Operator:
"Hallo" + " Welt!"
anfang + ende
dateiname + ".gif"


Gemischter Ausdruck mit Funktion(en):
dateiname + STR ("%.0m", i) + "." + erweiterung
zeichnungsNR + "-" + STRSUB("abcdefghij",index,1)


Ausdruck mit Autotext:
"Bauvorhaben: <PROJECTNAME>"

Aufklappen Beispiel Erläuterung
Strings sind Zeichenketten. Also aneinandergereihte einzelne Zeichen. Im Skript werden diese als "Klartext" zwischen je 2 Anführungszeichen oder Hochkommata gesetzt, wobei die begrenzenden Zeichen ignoriert werden und lediglich der Interpretation des Skriptes dienen.
GDL zeigt sich sehr flexibel, da alle möglichen Hochkomma oder Doppelhochkomma-Zeichen als Begrenzer von Zeichenketten interpretiert werden. Anfang und Ende müssen aber jeweils das gleiche Zeichen sein. Dann dürfen aber auch dazwischen andere Zeichen liegen, die sonst als Begrenzer dienen. Hauptsache Anfangs- und Endzeichen sind identisch.

Folgende Zuweisungen sind also zulässig:
string="'" ! string enthält '
string='"' ! string enthält "

Aufklappen Besonderheiten
Muss man einer Variablen einen besonders langen String zuweisen, kann es passieren, dass die Maximallänge einer Zeile (256 Zeichen) überschritten wird. In diesem Fall kann man mit +\ die Zuweisung über mehrere Zeilen erstrecken lassen:

string_var = "Ein sehr langer String, " +\
          "umgebrochen auf mehrere Zeilen " +\
          "während der Zuweisung."


Autotexte sind erstaunlicherweise und als einer der wenigen Stellen von GDL case-sensitive; daher darf man nicht <subsetname> verwenden, sondern nur <SUBSETNAME>.

Aufklappen Tipps und Tricks
Texte in Layouts (ab Plotmaker 3.0/Archicad 8; ab Archicad 10 auch innerhalb des Projektes) lassen besondere Platzhaltertexte zu, die Einstellungen aus den Projektinfos (Plotmaker: Buch>Buchinfo oder Archicad 10: Ablage>Info>Projektinfo) bzw. den platzierten Zeichnungen wiedergeben.
Die Texte können bereits in Archicad(objekten) eingesetzt werden, ihr tatsächlicher Inhalt wird aber ggf. erst zur Ausgabe ermittelt. Es handelt sich dabei nicht um Parameter oder Variablen. Der Inhalt ist von GDL aus nicht "lesbar".
Ab Archicad 10 kann der Inhaltstext für die Felder aus dem Projektinfo mehrzeilig sein.

Hier eine Liste der möglichen Platzhalter (Großschrift beachten!):

LAYOUT-Texte:

Layoutname /-nummer:
<LAYOUTNAME>, <LAYOUTNUMBER>
Layout-ID (ab Archicad 10):
<LAYOUTID>
Untergruppenname:
<SUBSETNAME>
Untergruppen-ID (ab Archicad 10):
<SUBSETID>
Untergruppennummer (bis Poltmaker 9):
<SUBSETNUMBER>
Anzahl der Layouts (ab Archicad 10):
<NUMOFLAYOUTS>
Seitenummer /Anzahl Seiten (bis Poltmaker 9):
<PAGE> <TOTPAGE>

ZEICHNUNG-Texte:

Zeichnungsname:
<DRAWINGNAME>
Zeichnungs-ID (ab Archicad 10):
<DRAWINGID>
Zeichnungsname mit Erweiterung /-pfad (bis Poltmaker 9):
<DRAWINGNAMEEXT> <DRAWINGPATH>
Zeichnungsmaßstab:
<DRAWINGSCALE>
Vergrößerung / Originalmaßstab (ab Archicad 10):
<MAGNIFICATION> <ORIGINALSCALE>
Ausgabemaßstab (bis Poltmaker 9):
<OUTPUTSCALE>

SYSTEM-Texte:

Aktuelle Zeit: langes Datum / kurzes Datum / nur Zeit:
<LONGDATE> <SHORTDATE> <TIME>
Dateiname /-pfad (ab Archicad 10):
<FILENAME> <FILEPATH>
(AC Datei) Projektdateiname /-pfad (bis Poltmaker 9):
<ACFILENAME> <ACFILEPATH>
Layoutbuchname /-pfad (bis Poltmaker 9):
<BOOKNAME> <BOOKPATH>
(Zeichnung) Zuletzt gesichert am / von:
<LASTSAVEDAT> <LASTSAVEDBY>

PROJEKTINFO-Texte:

Auftraggeber:
<CLIENT>
Projektname/Projektnummer:
<PROJECTNAME> <PROJECTNUMBER>
Straße / Stadt / Land / Postleitzahl:
<STREET> <CITY> <COUNTRY> <CODE>
Firma / Architekt / CAD-Techniker (Zeichner):
<COMPANY> <ARCHITECT> <DRAFTSMEN>
Projektstatus / Bearbeitungsdatum (Datum der Ausgabe):
<PROJECTSTATUS> <DATEOFISSUE>
Kurzbeschreibung / Anmerkungen (ab Archicad 10):
<KEYWORDS> <NOTES>
Individuell 1 / 2 / 3:
<CUSTOM1> <CUSTOM2> <CUSTOM3>