read_io_channelT_read_io_channelReadIoChannelread_io_channelReadIoChannelReadIoChannel (Operator)

Name

read_io_channelT_read_io_channelReadIoChannelread_io_channelReadIoChannelReadIoChannel — Lesen von Daten auf I/O-Übertragungskanälen.

Signatur

read_io_channel( : : IOChannelHandle : Value, Status)

read_io_channelread_io_channelReadIoChannelread_io_channelReadIoChannelReadIoChannel liest Eingabedaten von den angegebenen Übertragungskanälen. Die Kanäle werden dem Parameter IOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandle übergeben, die Daten in ValueValueValueValueValuevalue zurückgegeben. Der Parameter StatusStatusStatusStatusStatusstatus gibt für jeden gelesenen Wert in ValueValueValueValueValuevalue eine Statusmeldung zurück. Der Wert 0 zeigt an, dass das korrespondierende Datum in ValueValueValueValueValuevalue 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'"doc/html/reference/io""doc/html/reference/io""doc/html/reference/io""doc/html/reference/io""doc/html/reference/io".

Parallelisierung

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

IOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandle (input_control) io_channel(-array) → (integer)

Referenzen auf die geöffneten I/O-Übertragungskanäle.

ValueValueValueValueValuevalue (output_control) tuple-array → (integer / real / string)

Gelesene Daten.

StatusStatusStatusStatusStatusstatus (output_control) integer-array → (integer)

Statusrückmeldung für gelesene Daten.

Ergebnis

Im Falle gültiger Parameterwerte liefert der Operator read_io_channelread_io_channelReadIoChannelread_io_channelReadIoChannelReadIoChannel 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_infoget_extended_error_infoGetExtendedErrorInfoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfo abgefragt werden kann.

Vorgänger

open_io_channelopen_io_channelOpenIoChannelopen_io_channelOpenIoChannelOpenIoChannel, set_io_channel_paramset_io_channel_paramSetIoChannelParamset_io_channel_paramSetIoChannelParamSetIoChannelParam

Nachfolger

close_io_channelclose_io_channelCloseIoChannelclose_io_channelCloseIoChannelCloseIoChannel

Siehe auch

write_io_channelwrite_io_channelWriteIoChannelwrite_io_channelWriteIoChannelWriteIoChannel, query_io_devicequery_io_deviceQueryIoDevicequery_io_deviceQueryIoDeviceQueryIoDevice, set_io_channel_paramset_io_channel_paramSetIoChannelParamset_io_channel_paramSetIoChannelParamSetIoChannelParam

Modul

Foundation

Operatoren