Name
REQUEST
Syntax
REQUEST (abfragetext, abfrageobjekt, variable1 [, variable2, ... variablen])
Wertebereicheabfragetext, Typ Text
abfrageobjekt, Typ abhängig von abfragetext
variablei, Typ abhängig von abfragetext
abfrageobjekt, Typ abhängig von abfragetext
variablei, Typ abhängig von abfragetext
ErläuterungDie 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=abfragetext). Ggf. werden Optionen oder Parameter für die Abfrage übergeben (=abfrageobjekt). 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 abfragetexte sind vordefiniert und unter Umgebungswerte/REQUEST beschrieben. Dort werden auch differenziert Referenzen und Verfügbarkeit angegeben.
Ist ein abfragetext nicht vorgesehen, wird geprüft, ob im AddOn-Ordner der Programminstallation eine passende Erweiterung vorliegt. Wenn vorhanden wird dieser das abfrageobjekt übergeben und die Rückgabewerte des AddOns an variablei übertragen.
Per REQUEST() wird eine Abfrage gestartet (Art=abfragetext). Ggf. werden Optionen oder Parameter für die Abfrage übergeben (=abfrageobjekt). 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 abfragetexte sind vordefiniert und unter Umgebungswerte/REQUEST beschrieben. Dort werden auch differenziert Referenzen und Verfügbarkeit angegeben.
Ist ein abfragetext nicht vorgesehen, wird geprüft, ob im AddOn-Ordner der Programminstallation eine passende Erweiterung vorliegt. Wenn vorhanden wird dieser das abfrageobjekt übergeben und die Rückgabewerte des AddOns an variablei übertragen.
BesonderheitenDie REQUEST-Funktion kann auch als Kurzform zur Abfrage von AddOns verwendet werden. Findet der Interpreter keine vordefinierte Abfrage zu abfragetext, wird abfragetext 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.
ArchiCADab 5.0