read_serial — Lesen von einem seriellen Gerät.
read_serial( : : SerialHandle, NumCharacters : Data)
read_serial versucht, NumCharacters von dem
seriellen Gerät, das durch SerialHandle angegeben wird, zu
lesen. Die gelesenen Daten werden in Data als Tupel von
Integer-Werten zurückgegeben. Dies erlaubt das Lesen von
NUL-Zeichen, die sonst als String-Ende interpretiert würden. Falls
der Timeout des Gerätes mit set_serial_param auf einen Wert
größer als 0 gesetzt wurde, wird so lange auf die Ankunft des
ersten Zeichens gewartet, wie durch den Timeout angegeben ist, ansonsten
kehrt die Funktion sofort zurück. In jedem Fall werden die zur
Zeit der Rückkehr verfügbaren Zeichen zurückgeliefert. D.h., es
können weniger Zeichen als angefordert zurückgeliefert werden.
Dies kann über die Länge des Tupels Data überprüft
werden.
SerialHandle (input_control) serial → (handle)
Handle der seriellen Schnittstelle.
NumCharacters (input_control) integer → (integer)
Anzahl der zu lesenden Zeichen.
Defaultwert: 1
Wertevorschläge: 1, 2, 3, 4, 5, 10, 20, 40, 100
Data (output_control) integer(-array) → (integer)
Gelesene Zeichen (als Integer-Tupel).
Wenn die Parameter korrekt sind und das Lesen vom seriellen Gerät
erfolgreich war, liefert read_serial den Wert 2 (H_MSG_TRUE).
Andernfalls wird eine Fehlerbehandlung durchgeführt.
Foundation