coord-transf.2d elements3d elementsnon geo scriptsfunctionscontrol statem.attributesvariousaddons
arithmeticscirclemathematicsstatisticsstringarraybinaryspecial
REQ REQUEST REQUEST{2} IND NTR VARTYPE
Name
REQUEST
Syntax
REQUEST(question_text, question_object, variable1 [, variable2, ... variablen])
Aufklappen Range
question_text, Typ Text
question_object, Typ abhängig von question_text
variablei, Typ abhängig von question_text
Aufklappen Description
Die Funktion fragt Zustände des Programms, des Objektes oder anderer Elemente ab. Die Verfügbarkeit ist z.T. kontextabhängig. Da bei einer mathematischen Funktion nur 1 Wert zurückgegeben werden kann und häufig mehr als 1 Antwort auf eine Anfrage zu erwarten sind, funktioniert REQUEST() eher wie eine Makrofunktion oder ein Unterprogramm.
Per REQUEST() wird eine Abfrage gestartet (Art=question_text). Ggf. werden Optionen oder Parameter für die Abfrage übergeben (=question_object). Das Ergebnis der Abfrage wird an eine oder mehrere Variablen (variablei) übergeben.
Der eigentliche Funktionswert ist der Status dieser Funktion nach Ausführung. Es wird die Anzahl der Antworten zurückgegeben. Ist die Anfrage nicht erlaubt oder undefiniert, lautet das Ergebnis 0.

Die zulässigen question_texte sind vordefiniert und unter Umgebungswerte/REQUEST beschrieben. Dort werden auch differenziert Referenzen und Verfügbarkeit angegeben.

Ist ein question_text nicht vorgesehen, wird geprüft, ob im AddOn-Ordner der Programminstallation eine passende Erweiterung vorliegt. Wenn vorhanden wird dieser das question_object übergeben und die Rückgabewerte des AddOns an variablei übertragen.
Aufklappen Specialities
Die REQUEST-Funktion kann auch als Kurzform zur Abfrage von AddOns verwendet werden. Findet der Interpreter keine vordefinierte Abfrage zu question_text, wird question_text als Name eines AddOns interpretiert und eine Abfrage des AddOns durch eine intern ablaufende OPEN - INPUT -CLOSE- Sequenz versucht. Einzig dokumentiert ist das mit dem AddOn "DateTime". Denkbar wäre das noch für "File I/O" oder "Property", haben wir aber nicht untersucht.
Aufklappen ArchiCAD®
since 5.0