control_io_channelT_control_io_channelControlIoChannelControlIoChannelcontrol_io_channel控制输入输出通道(算子)
名称
control_io_channelT_control_io_channelControlIoChannelControlIoChannelcontrol_io_channel — 在输入/输出通道上执行操作。
签名
def control_io_channel(iochannel_handle: MaybeSequence[HHandle], action: str, argument: Sequence[Union[int, float, str]]) -> Sequence[Union[int, float, str]]
描述
control_io_channelcontrol_io_channelControlIoChannelControlIoChannelControlIoChannelcontrol_io_channel 对指定的 I/O 通道执行操作。支持的参数因接口而异,具体列表详见所用 I/O 接口的对应文档,该文档位于 doc/html/reference/io 目录中。
执行信息
- 多线程类型:可重入(与非独占算子并行运行)。
- 多线程作用域:全局(可从任何线程调用)。
- 未采用并行化处理。
参数
IOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleIOChannelHandleiochannel_handle (输入控制) io_channel(-array) → HIOChannel, HTupleMaybeSequence[HHandle]HTupleHtuple (handle) (IntPtr) (HHandle) (handle)
已打开 I/O 通道的句柄。
ActionActionActionActionactionaction (输入控制) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
要执行的操作名称。
ArgumentArgumentArgumentArgumentargumentargument (输入控制) string-array → HTupleSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
操作的参数列表。
默认值:
[]
ResultResultResultResultresultresult (输出控制) string-array → HTupleSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
操作返回的值列表。
结果
如果参数有效,算子 control_io_channelcontrol_io_channelControlIoChannelControlIoChannelControlIoChannelcontrol_io_channel 返回值 2 (H_MSG_TRUE)。如有必要,则抛出异常。在此情况下,可设置扩展错误信息,并可通过算子 get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info 进行查询。
可能的前趋
open_io_channelopen_io_channelOpenIoChannelOpenIoChannelOpenIoChannelopen_io_channel
模块
基础