4D Doc Center : RECEIVE VARIABLE

Home

4D v14.3

RECEIVE VARIABLE


RECEIVE VARIABLE ( Variablenname )

Parameter	Typ	Beschreibung
Variablenname	Variable	Zu empfangende Variable

Beschreibung

Der Befehl RECEIVE VARIABLE wartet auf den Empfang der Variablen Variablenname von der seriellen Schnittstelle oder von dem durch den Befehl SET CHANNEL geöffneten Dokument. RECEIVE VARIABLE erhält die Variable im internen 4D-Format. Die Variable muss von einer anderen 4D-Anwendung mit SEND VARIABLE oder aus einem Dokument, das von einer 4D Anwendung erzeugt wurde, abgeschickt worden sein.

Existiert die Variable im interpretierten Modus vor Aufrufen von RECEIVE VARIABLE noch nicht, wird sie gemäß den empfangenen Daten erstellt, typisiert und zugewiesen. Im kompilierten Modus muss sie vom selben Typ wie die empfangenen Daten sein.

Anmerkungen

Senden Sie mit diesem Befehl eine Variable zu einem Dokument, muss es zuvor mit dem Befehl SET CHANNEL geöffnet werden. Sie können RECEIVE VARIABLE nicht für Dokumente verwenden, die mit Open document, Create document oder Append document geöffnet wurden.
Dieser Befehl unterstützt keine Variablen vom Typ Array. Wollen Sie Arrays in bzw. aus einem Dokument oder einer seriellen Schnittstelle ein- bzw. auslesen, verwenden Sie die BLOB Befehle.
Der Benutzer kann während der Ausführung von RECEIVE VARIABLE den Empfang unterbrechen, und zwar unter Windows durch die Tastenkombination Strg-, Alt- und Umschalttaste, auf Macintosh Wahl-, Befehls- und Umschalttaste. Die Unterbrechung generiert den Fehler -9994. Sie können ihn mit einer Methode ON ERR CALL abfangen.

Beispiel

Siehe Beispiel zum Befehl RECEIVE RECORD.

Systemvariablen und Mengen

Die Systemvariable OK hat den Wert 1, wenn die Variable empfangen wurde. Wurde die Kommunikation unterbrochen oder trat ein Übertragungsfehler auf, ergibt OK den Wert 0.