read_io_channelT_read_io_channelReadIoChannelReadIoChannelread_io_channel (算子名称)
名称
read_io_channelT_read_io_channelReadIoChannelReadIoChannelread_io_channel — Read a value from the specified I/O channels.
参数签名
def read_io_channel(iochannel_handle: MaybeSequence[HHandle]) -> Tuple[Sequence[HTupleElementType], Sequence[int]]
描述
read_io_channelread_io_channelReadIoChannelReadIoChannelReadIoChannelread_io_channel reads input values from the specified
transmission channels. The channels are passed in
IOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleiochannel_handle and can be opened and configured by
open_io_channelopen_io_channelOpenIoChannelOpenIoChannelOpenIoChannelopen_io_channel, the values are returned in
ValueValueValueValuevaluevalue. The parameter StatusStatusStatusStatusstatusstatus returns for each read
value in ValueValueValueValuevaluevalue a quality message. The value 0
indicates that the corresponding value of ValueValueValueValuevaluevalue could be
read. Any other status value depends on the interface. Please refer
to the interface-specific documentation in the directory
doc/html/reference/io for further explanation.
运行信息
- 多线程类型:可重入(与非独占操作符并行运行)。
- 多线程作用域:全局(可以从任何线程调用)。
- 未经并行化处理。
参数表
IOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleiochannel_handle (input_control) io_channel(-array) → HIOChannel, HTupleMaybeSequence[HHandle]HTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handles of the opened I/O channels.
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)
Read value.
StatusStatusStatusStatusstatusstatus (output_control) integer-array → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Status of read value.
结果
如果参数均有效，算子
read_io_channelread_io_channelReadIoChannelReadIoChannelReadIoChannelread_io_channel 返回值 2 (
H_MSG_TRUE)
. If necessary an
exception is raised. In this case, an extended error information may be
set and can be queried with 该算子 get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info.
可能的前置算子
open_io_channelopen_io_channelOpenIoChannelOpenIoChannelOpenIoChannelopen_io_channel,
set_io_channel_paramset_io_channel_paramSetIoChannelParamSetIoChannelParamSetIoChannelParamset_io_channel_param
可能的后置算子
close_io_channelclose_io_channelCloseIoChannelCloseIoChannelCloseIoChannelclose_io_channel
参考其它
write_io_channelwrite_io_channelWriteIoChannelWriteIoChannelWriteIoChannelwrite_io_channel,
query_io_devicequery_io_deviceQueryIoDeviceQueryIoDeviceQueryIoDevicequery_io_device,
set_io_channel_paramset_io_channel_paramSetIoChannelParamSetIoChannelParamSetIoChannelParamset_io_channel_param
模块
Foundation