write_io_channelT_write_io_channelWriteIoChannelWriteIoChannelwrite_io_channel (Operator)
Name
write_io_channelT_write_io_channelWriteIoChannelWriteIoChannelwrite_io_channel — Schreiben von Daten auf I/O-Übertragungskanälen.
Signatur
def write_io_channel(iochannel_handle: MaybeSequence[HHandle], value: Sequence[Union[int, float, str]]) -> Sequence[int]
Beschreibung
write_io_channelwrite_io_channelWriteIoChannelWriteIoChannelWriteIoChannelwrite_io_channel schreibt Daten auf die angegebenen
Übertragungskanäle. Die Referenzen zu den Instanzen der
Übertragungskanäle werden dem Parameter IOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleiochannel_handle,
die Daten dem Parameter ValueValueValueValuevaluevalue übergeben. Der Parameter
StatusStatusStatusStatusstatusstatus gibt für jedes übergebene Datum in ValueValueValueValuevaluevalue
eine Statusmeldung zurück. Der Wert 0 zeigt an, dass das
korrespondierende Datum in ValueValueValueValuevaluevalue auf dem Kanal korrekt
geschrieben 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 (input_control) tuple-array → HTupleSequence[Union[int, float, str]]HTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Zu schreibende Daten.
StatusStatusStatusStatusstatusstatus (output_control) integer-array → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Statusrückmeldung für geschriebene Daten.
Ergebnis
Im Falle gültiger Parameterwerte liefert der Operator
write_io_channelwrite_io_channelWriteIoChannelWriteIoChannelWriteIoChannelwrite_io_channel den Wert TRUE, unabhängig vom
Erfolg des Schreibens. 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
read_io_channelread_io_channelReadIoChannelReadIoChannelReadIoChannelread_io_channel,
open_io_channelopen_io_channelOpenIoChannelOpenIoChannelOpenIoChannelopen_io_channel,
query_io_devicequery_io_deviceQueryIoDeviceQueryIoDeviceQueryIoDevicequery_io_device,
set_io_channel_paramset_io_channel_paramSetIoChannelParamSetIoChannelParamSetIoChannelParamset_io_channel_param
Modul
Foundation