Operator Reference

HALCON Operator Reference / Tuple / Conversion

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

integer_to_handleT_integer_to_handleIntegerToHandleIntegerToHandleinteger_to_handle (Operator)

integer_to_handleT_integer_to_handleIntegerToHandleIntegerToHandleinteger_to_handle — Convert an integer into a handle.

Warning

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

Signature

integer_to_handle( : : IntegerHandle : Handle)

Herror T_integer_to_handle(const Htuple IntegerHandle, Htuple* Handle)

void IntegerToHandle(const HTuple& IntegerHandle, HTuple* Handle)

static void HOperatorSet.IntegerToHandle(HTuple integerHandle, out HTuple handle)

def integer_to_handle(integer_handle: MaybeSequence[int]) -> Sequence[HHandle]

def integer_to_handle_s(integer_handle: MaybeSequence[int]) -> HHandle

Description

integer_to_handleinteger_to_handleIntegerToHandleIntegerToHandleinteger_to_handle converts the integer IntegerHandleIntegerHandleIntegerHandleintegerHandleinteger_handle, that represents a handle, to a handle of type HANDLE_PAR and returns it in HandleHandleHandlehandlehandle. 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 HandleHandleHandlehandlehandle, are overwritten. In that case, if the original IntegerHandleIntegerHandleIntegerHandleintegerHandleinteger_handle should continue to be used, a reference to the returned HandleHandleHandlehandlehandle 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_handleClearHandleClearHandleclear_handle or the clear operator of the corresponding semantic type of the handle.

Attention

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

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

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.

Parameters

IntegerHandleIntegerHandleIntegerHandleintegerHandleinteger_handle (input_control)  pointer(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

The handle as integer.

HandleHandleHandlehandlehandle (output_control)  handle(-array) → HHandle, HTupleSequence[HHandle]HTupleHtuple (handle) (IntPtr) (HHandle) (handle)

The handle as handle.

Result

If the parameters are valid, the operator integer_to_handleinteger_to_handleIntegerToHandleIntegerToHandleinteger_to_handle returns the value 2 ( H_MSG_TRUE) . Otherwise, an exception is raised.

See also

handle_to_integerhandle_to_integerHandleToIntegerHandleToIntegerhandle_to_integer

Module

Foundation

---

ClassesClasses | | Operators