write_io_channelT_write_io_channelWriteIoChannelwrite_io_channelWriteIoChannelWriteIoChannel (Operator)

Name

write_io_channelT_write_io_channelWriteIoChannelwrite_io_channelWriteIoChannelWriteIoChannel — Schreiben von Daten auf I/O-Übertragungskanälen.

Signatur

write_io_channel( : : IOChannelHandle, Value : Status)

write_io_channelwrite_io_channelWriteIoChannelwrite_io_channelWriteIoChannelWriteIoChannel schreibt Daten auf die angegebenen Übertragungskanäle. Die Referenzen zu den Instanzen der Übertragungskanäle werden dem Parameter IOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandle, 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'"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 (input_control) tuple-array → (integer / real / string)

Zu scheibende Daten.

StatusStatusStatusStatusStatusstatus (output_control) integer-array → (integer)

Statusrückmeldung für geschriebene Daten.

Ergebnis

Im Falle gültiger Parameterwerte liefert der Operator write_io_channelwrite_io_channelWriteIoChannelwrite_io_channelWriteIoChannelWriteIoChannel den Wert 2 (H_MSG_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_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

read_io_channelread_io_channelReadIoChannelread_io_channelReadIoChannelReadIoChannel, open_io_channelopen_io_channelOpenIoChannelopen_io_channelOpenIoChannelOpenIoChannel, query_io_devicequery_io_deviceQueryIoDevicequery_io_deviceQueryIoDeviceQueryIoDevice, set_io_channel_paramset_io_channel_paramSetIoChannelParamset_io_channel_paramSetIoChannelParamSetIoChannelParam

Modul

Foundation

Operatoren