read_io_channelT_read_io_channelReadIoChannelReadIoChannelread_io_channel (Operator)
Name
read_io_channelT_read_io_channelReadIoChannelReadIoChannelread_io_channel — Lesen von Daten auf I/O-Übertragungskanälen.
Signatur
def read_io_channel(iochannel_handle: MaybeSequence[HHandle]) -> Tuple[Sequence[HTupleElementType], Sequence[int]]
Beschreibung
read_io_channelread_io_channelReadIoChannelReadIoChannelReadIoChannelread_io_channel liest Eingabedaten von den angegebenen
Übertragungskanälen. Die Kanäle werden dem Parameter
IOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleiochannel_handle ü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.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
IOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleiochannel_handle (input_control) io_channel(-array) → HIOChannel, HTupleMaybeSequence[HHandle]HTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Referenzen auf die geöffneten I/O-Übertragungskanäle.
ValueValueValueValuevaluevalue (output_control) tuple-array → HTupleSequence[HTupleElementType]HTupleHtuple (integer / real / string / handle) (int / long / double / string / HHandle) (Hlong / double / HString / HHandle) (Hlong / double / char* / handle)
Gelesene Daten.
StatusStatusStatusStatusstatusstatus (output_control) integer-array → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Statusrückmeldung für gelesene Daten.
Ergebnis
Im Falle gültiger Parameterwerte liefert der Operator
read_io_channelread_io_channelReadIoChannelReadIoChannelReadIoChannelread_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_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info abgefragt werden kann.
Vorgänger
open_io_channelopen_io_channelOpenIoChannelOpenIoChannelOpenIoChannelopen_io_channel,
set_io_channel_paramset_io_channel_paramSetIoChannelParamSetIoChannelParamSetIoChannelParamset_io_channel_param
Nachfolger
close_io_channelclose_io_channelCloseIoChannelCloseIoChannelCloseIoChannelclose_io_channel
Siehe auch
write_io_channelwrite_io_channelWriteIoChannelWriteIoChannelWriteIoChannelwrite_io_channel,
query_io_devicequery_io_deviceQueryIoDeviceQueryIoDeviceQueryIoDevicequery_io_device,
set_io_channel_paramset_io_channel_paramSetIoChannelParamSetIoChannelParamSetIoChannelParamset_io_channel_param
Modul
Foundation