integer_to_handleT_integer_to_handleIntegerToHandleIntegerToHandleinteger_to_handle (算子名称)

名称

integer_to_handleT_integer_to_handleIntegerToHandleIntegerToHandleinteger_to_handle — Convert an integer into a handle.

警告

It is not recommended to use this operator in HDevelop. This operator is only provided for reasons of backward compatibility.

参数签名

描述

integer_to_handleinteger_to_handleIntegerToHandleIntegerToHandleIntegerToHandleinteger_to_handle converts the integer IntegerHandleIntegerHandleIntegerHandleIntegerHandleintegerHandleinteger_handle, that represents a handle, to a handle of type HANDLE_PAR and returns it in HandleHandleHandleHandlehandlehandle. This allows to convert handles created in code parts where the legacy handle mode is enabled into proper handles.

If the legacy handle mode is disabled (the default), the ownership of the handle is transferred onto the handle. In this case, the handle will automatically be cleared once all references to that handle, such as in the tuple HandleHandleHandleHandlehandlehandle, are overwritten. In that case, if the original IntegerHandleIntegerHandleIntegerHandleIntegerHandleintegerHandleinteger_handle should continue to be used, a reference to the returned HandleHandleHandleHandlehandlehandle must be kept in order to avoid clearing the handle.

If the legacy handle mode is enabled, the returned value will again be an integer. Additionally, the handle must then be cleared using clear_handleclear_handleClearHandleClearHandleClearHandleclear_handle or the clear operator of the corresponding semantic type of the handle.

注意

It is not recommended to use this operator in HDevelop. This operator is solely provided to enable backward compatibility with legacy code.

运行信息

• 多线程类型:可重入(与非独占操作符并行运行)。
• 多线程作用域:全局(可以从任何线程调用)。
• 未经并行化处理。

This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.

参数表

结果

如果参数均有效，算子 integer_to_handleinteger_to_handleIntegerToHandleIntegerToHandleIntegerToHandleinteger_to_handle 返回值 2 ( H_MSG_TRUE) . Otherwise, an exception is raised.

参考其它

handle_to_integerhandle_to_integerHandleToIntegerHandleToIntegerHandleToIntegerhandle_to_integer

模块

Foundation