get_handle_tupleT_get_handle_tupleGetHandleTupleGetHandleTupleget_handle_tuple (算子)
名称
get_handle_tupleT_get_handle_tupleGetHandleTupleGetHandleTupleget_handle_tuple — 从句柄中检索与键关联的元组。
签名
Herror T_get_handle_tuple(const Htuple Handle, const Htuple Key, Htuple* Tuple)
void GetHandleTuple(const HTuple& Handle, const HTuple& Key, HTuple* Tuple)
def get_handle_tuple(handle: HHandle, key: Union[str, int]) -> Sequence[Union[int, float, str]]
def get_handle_tuple_s(handle: HHandle, key: Union[str, int]) -> Union[int, float, str]
描述
get_handle_tupleget_handle_tupleGetHandleTupleGetHandleTupleGetHandleTupleget_handle_tuple retrieves a tuple associated with the KeyKeyKeyKeykeykey
from HandleHandleHandleHandlehandlehandle and returns it in TupleTupleTupleTupletupletuple.
The list of keys supported by a handle can be queried with
get_handle_paramget_handle_paramGetHandleParamGetHandleParamGetHandleParamget_handle_param。
Note that this operator is provided only for implementing generic
debug and inspection mechanisms.
The keys returned for certain handle types can change without notice.
Additionally, some handle types might not be supported by this operator.
Also, this operator is not optimized for performance.
To obtain more reliable information about a handle in a program, it is
strongly recommended to use the operators specialized for the particular
handle type, such as get_object_model_3d_paramsget_object_model_3d_paramsGetObjectModel3dParamsGetObjectModel3dParamsGetObjectModel3dParamsget_object_model_3d_params,
get_generic_shape_model_paramget_generic_shape_model_paramGetGenericShapeModelParamGetGenericShapeModelParamGetGenericShapeModelParamget_generic_shape_model_param etc.
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
参数
HandleHandleHandleHandlehandlehandle (输入控制) handle → HHandle, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of which to get the key.
KeyKeyKeyKeykeykey (输入控制) string → HTupleUnion[str, int]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Key to get.
元素数量：
Key == 1
限制：
length(Key) > 0
TupleTupleTupleTupletupletuple (输出控制) tuple(-array) → HTupleSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Control value of the key.
结果
如果参数有效，算子 get_handle_tupleget_handle_tupleGetHandleTupleGetHandleTupleGetHandleTupleget_handle_tuple 返回值 2 ( H_MSG_TRUE )。
If the handle is invalid or does not support the given key, or if the
key references an iconic object instead of a tuple, an exception is raised.
可能的前趋
get_handle_paramget_handle_paramGetHandleParamGetHandleParamGetHandleParamget_handle_param
替代
get_handle_objectget_handle_objectGetHandleObjectGetHandleObjectGetHandleObjectget_handle_object
另见
get_handle_paramget_handle_paramGetHandleParamGetHandleParamGetHandleParamget_handle_param,
get_handle_objectget_handle_objectGetHandleObjectGetHandleObjectGetHandleObjectget_handle_object
模块
基础