4D Doc Center : RECEIVE PACKET

Home

4D v14.3

RECEIVE PACKET


RECEIVE PACKET ( {DokRef ;} EmpfangeVar ; StopChar \| NumBytes )

Parameter	Typ	Beschreibung
DokRef	DokRef	Referenznummer des Dokuments oder aktueller Kanal (serielle Schnittstelle oder Dokument)
EmpfangeVar	Textvariable, BLOB Variable	Variable zum Empfangen des Textes
StopChar \| NumBytes	String, Lange Ganzzahl	Zeichen, bis zu dem Daten empfangen werden, oder Anzahl zu empfangender Bytes

Beschreibung

Der Befehl RECEIVE PACKET liest die Daten von einer seriellen Schnittstelle oder von einem Dokument.

Ist DokRef definiert, findet dieser Befehl Daten aus einem Dokument, das mit Open document, Create document oder Append document geöffnet wurde. Ist DokRef nicht definiert, findet dieser Befehl Daten aus einer seriellen Schnittstelle oder einem Dokument, das mit SET CHANNEL geöffnet wurde.

Die eingelesenen Zeichen werden, unabhängig von der Quelle, in EmpfangeVar zurückgegeben. Dies muss eine Variable von Typ Text, String oder BLOB sein. Wurden die Zeichen über den Befehl SEND PACKET gesendet, muss der Typ zu dem des gesendeten Pakets passen.

Hinweise:

Ist das empfangene Paket vom Typ BLOB, berücksichtigt es keine Zeichen, die über USE CHARACTER SET angegeben wurden. Das BLOB wird ohne Änderung gesendet.
Ist das empfangene Paket vom Typ Text, unterstützt RECEIVE PACKET BOMs (Byte Order Marks). Ist in diesem Fall der aktuelle Zeichensatz vom Typ Unicode (UTF-8, UTF-16 oder UTF-32), versucht 4D unter den ersten empfangenen Bytes ein BOM zu identifizieren. Wurde es gefunden, wird es aus dem Ergebnis gefiltert und 4D verwendet den hier definierten Zeichensatz statt des aktuellen.

Um eine bestimmte Anzahl Zeichen einzulesen, übergeben Sie diese Anzahl in NumBytes. Ist die Variable EmpfangeVar vom Typ Text, können Sie in einem Aufruf theoretisch bis zu 2 GB Text einlesen.

Um Zeichen bis zu einem bestimmten String einzulesen (bestehend aus ein oder mehreren Zeichen), übergeben Sie diesen String in StopChar. Er wird nicht in EmpfangeVar zurückgegeben.

Wird der in StopChar angegebene String nicht gefunden, gilt folgendes:

Beim Lesen eines Dokuments stoppt RECEIVE PACKET am Ende des Dokuments.
Beim Auslesen von Daten aus einer seriellen Schnittstelle wartet RECEIVE PACKET unendlich, bis ein Timeout eintritt (siehe SET TIMEOUT) oder bis der Benutzer den Empfang abbricht.

Beim Ausführen von RECEIVE PACKET kann der Benutzer dem Empfang durch gleichzeitiges Drücken der Strg-, Alt- und Umschalttaste bzw. auf Macintosh der Wahl-, Befehls- und Umschalttaste unterbrechen. Die Unterbrechung generiert den Fehler -9994. Sie können ihn mit einer Fehlerverwaltungsmethode, installiert mit ON ERR CALL, abfangen. Eine Unterbrechung des Empfangs ist in der Regel nur bei der Kommunikation über eine serielle Schnittstelle erforderlich.

Beim Auslesen eines Dokuments beginnt das erste RECEIVE PACKET am Anfang des Dokuments auszulesen. Alle darauffolgenden Datenpakete beginnen mit dem Zeichen, das auf das zuletzt gelesene Byte folgt.

Hinweis: Sie können diesen Befehl verwenden für ein Dokument, das mit SET CHANNEL geöffnet wurde. Für ein Dokument, das mit Open document, Create document oder Append document geöffnet wurde, können Sie mit den Befehlen Get document position und SET DOCUMENT POSITION die Position festlegen oder ändern, wo das nächste Auslesen (SEND PACKET) oder Einlesen (RECEIVE PACKET) stattfinden soll.

Versuchen Sie, über das Ende einer Datei hinaus zu lesen, gibt RECEIVE PACKET die gelesenen Daten bis zu diesem Punkt zurück und setzt die Systemvariable auf 1. Das nächste RECEIVE PACKET gibt eine leere Zeichenkette zurück und setzt die Systemvariable auf 0.

Beispiel 1

Folgendes Beispiel liest 20 Zeichen aus einer seriellen Schnittstelle in die Variable getTwenty:

RECEIVE PACKET(getTwenty;20)

Beispiel 2

Folgendes Beispiel liest Daten aus dem in der Variablen myDoc zugewiesenen Dokument in die Variable vData. Ausgelesen wird bis zur Zeilenschaltung:

RECEIVE PACKET(myDoc;vData;Char(Carriage return))

Beispiel 3

Folgendes Beispiel liest Daten aus dem in der Variablen myDoc zugewiesenen Dokument in die Variable vData. Ausgelesen wird bis zum HTML Tag </TD> (Ende der Tabellenzelle):

RECEIVE PACKET(myDoc;vData;"</TD>")

Beispiel 4

Folgendes Beispiel liest Daten von einem Dokument in Datenfelder. Die Daten werden in Datenfelder von fester Länge gespeichert. Die darin enthaltene Methode ruft eine Unterroutine auf, die schleifende Leerzeichen entfernt (Leerzeichen am Ende von Zeichenketten):

 $vhDocRef :=Open document("";"TEXT") ` Öffne ein TEXT Dokument

 If(OK=1) `Wurde das Dokument geöffnet

    Repeat ` Durchlaufe bis keine Daten mehr da sind

       RECEIVE PACKET($vhDocRef;$Var1;15) ` Lies 15 Zeichen

       RECEIVE PACKET($vhDocRef;$Var2;15) `Führe dasselbe für das 2. Feld aus

       If(($Var1#"")|($Var2#"")) `Ist mindestens eins der Felder nicht leer

          CREATE RECORD([People]) ` Erstelle neuen Datensatz

          [People]First :=Strip($Var1) ` Sichere den ersten Namen

          [People]Last :=Strip($Var2) ` Sichere den letzten Namen

          SAVE RECORD([People]) ` Sichere den Datensatz

       End if

    Until(OK=0)

    CLOSE DOCUMENT($vhDocRef) ` Schließe das Dokument

 End if

Nachfolgende Methode Strip entfernt die Leerzeichen am Ende der Daten:

 For($i;Length($1);1;-1) ` Durchlaufe vom Ende des Zeichensatzes bis zum Start

    If($1≤$i≥#" ") ` Ist kein Leerzeichen vorhanden

       $i :=-$i  ` Beende die Schleife

    End if

 End for

 $0:=Delete string($1;-$i;Length($1)) ` Lösche die Leerzeichen

Systemvariablen und Mengen

Nach Aufrufen von RECEIVE PACKET hat die Systemvariable OK den Wert 1, wenn das Datenpaket ohne Fehler empfangen wurde. Wurde die Kommunikation unterbrochen oder bei einem Übertragungsfehler hat OK den Wert 0.