read_io_channel
— Lesen von Daten auf I/O-Übertragungskanälen.
read_io_channel( : : IOChannelHandle : Value, Status)
read_io_channel
liest Eingabedaten von den angegebenen
Übertragungskanälen. Die Kanäle werden dem Parameter
IOChannelHandle
übergeben, die Daten in Value
zurückgegeben. Der Parameter Status
gibt für jeden gelesenen
Wert in Value
eine Statusmeldung zurück. Der Wert
0 zeigt an, dass das korrespondierende Datum in
Value
auf dem Kanal korrekt gelesen werden konnte. Die
Bedeutung anderer Statuswerte hängt vom jeweiligen Interface
ab. Ihre Beschreibung findet sich in der Dokumentation für die
verwendete I/O-Schnittstelle im Verzeichnis
'doc/html/reference/io' .
IOChannelHandle
(input_control) io_channel(-array) →
(handle)
Referenzen auf die geöffneten I/O-Übertragungskanäle.
Value
(output_control) tuple-array →
(integer / real / string)
Gelesene Daten.
Status
(output_control) integer-array →
(integer)
Statusrückmeldung für gelesene Daten.
Im Falle gültiger Parameterwerte liefert der Operator
read_io_channel
den Wert 2 (H_MSG_TRUE), unabhängig vom
Erfolg des Lesens. Andernfalls wird eine Fehlerbehandlung
durchgeführt. In diesem Fall kann vom Interface eine zusätzliche Fehlerinformation gesetzt werden, die mit get_extended_error_info
abgefragt werden kann.
open_io_channel
,
set_io_channel_param
write_io_channel
,
query_io_device
,
set_io_channel_param
Foundation