write_io_channelT_write_io_channelWriteIoChannelWriteIoChannel (Operator)

Name

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

Signatur

write_io_channel( : : IOChannelHandle, Value : Status)

Herror T_write_io_channel(const Htuple IOChannelHandle, const Htuple Value, Htuple* Status)

void WriteIoChannel(const HTuple& IOChannelHandle, const HTuple& Value, HTuple* Status)

static HTuple HIOChannel::WriteIoChannel(const HIOChannelArray& IOChannelHandle, const HTuple& Value)

HTuple HIOChannel::WriteIoChannel(const HTuple& Value) const

static void HOperatorSet.WriteIoChannel(HTuple IOChannelHandle, HTuple value, out HTuple status)

static HTuple HIOChannel.WriteIoChannel(HIOChannel[] IOChannelHandle, HTuple value)

HTuple HIOChannel.WriteIoChannel(HTuple value)

Beschreibung

write_io_channelwrite_io_channelWriteIoChannelWriteIoChannelWriteIoChannel schreibt Daten auf die angegebenen Übertragungskanäle. Die Referenzen zu den Instanzen der Übertragungskanäle werden dem Parameter IOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandle, die Daten dem Parameter ValueValueValueValuevalue übergeben. Der Parameter StatusStatusStatusStatusstatus gibt für jedes übergebene Datum in ValueValueValueValuevalue eine Statusmeldung zurück. Der Wert 0 zeigt an, dass das korrespondierende Datum in ValueValueValueValuevalue 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".

Ausführungsinformationen

Parameter

IOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandle (input_control)  io_channel(-array) HIOChannel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

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

ValueValueValueValuevalue (input_control)  tuple-array HTupleHTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)

Zu scheibende Daten.

StatusStatusStatusStatusstatus (output_control)  integer-array HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Statusrückmeldung für geschriebene Daten.

Ergebnis

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

Vorgänger

open_io_channelopen_io_channelOpenIoChannelOpenIoChannelOpenIoChannel, set_io_channel_paramset_io_channel_paramSetIoChannelParamSetIoChannelParamSetIoChannelParam

Nachfolger

close_io_channelclose_io_channelCloseIoChannelCloseIoChannelCloseIoChannel

Siehe auch

read_io_channelread_io_channelReadIoChannelReadIoChannelReadIoChannel, open_io_channelopen_io_channelOpenIoChannelOpenIoChannelOpenIoChannel, query_io_devicequery_io_deviceQueryIoDeviceQueryIoDeviceQueryIoDevice, set_io_channel_paramset_io_channel_paramSetIoChannelParamSetIoChannelParamSetIoChannelParam

Modul

Foundation