read_io_channelT_read_io_channelReadIoChannelReadIoChannel (Operator)

Name

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

Signatur

read_io_channel( : : IOChannelHandle : Value, Status)

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

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

static HTuple HIOChannel::ReadIoChannel(const HIOChannelArray& IOChannelHandle, HTuple* Status)

HTuple HIOChannel::ReadIoChannel(HTuple* Status) const

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

static HTuple HIOChannel.ReadIoChannel(HIOChannel[] IOChannelHandle, out HTuple status)

HTuple HIOChannel.ReadIoChannel(out HTuple status)

Beschreibung

read_io_channelread_io_channelReadIoChannelReadIoChannelReadIoChannel liest Eingabedaten von den angegebenen Übertragungskanälen. Die Kanäle werden dem Parameter IOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandle übergeben, die Daten in ValueValueValueValuevalue zurückgegeben. Der Parameter StatusStatusStatusStatusstatus gibt für jeden gelesenen Wert in ValueValueValueValuevalue eine Statusmeldung zurück. Der Wert 0 zeigt an, dass das korrespondierende Datum in ValueValueValueValuevalue 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".

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 (output_control)  tuple-array HTupleHTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)

Gelesene Daten.

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

Statusrückmeldung für gelesene Daten.

Ergebnis

Im Falle gültiger Parameterwerte liefert der Operator read_io_channelread_io_channelReadIoChannelReadIoChannelReadIoChannel 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_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

write_io_channelwrite_io_channelWriteIoChannelWriteIoChannelWriteIoChannel, query_io_devicequery_io_deviceQueryIoDeviceQueryIoDeviceQueryIoDevice, set_io_channel_paramset_io_channel_paramSetIoChannelParamSetIoChannelParamSetIoChannelParam

Modul

Foundation