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