Skip to content

integer_to_objIntegerToObjIntegerToObjinteger_to_objinteger_to_obj🔗

Short description🔗

integer_to_objIntegerToObjIntegerToObjinteger_to_objinteger_to_obj — Convert an “integer number” into an iconic object.

Signature🔗

integer_to_obj( out object Objects, pointer SurrogateTuple )void IntegerToObj( HObject* Objects, const HTuple& SurrogateTuple )static void HOperatorSet.IntegerToObj( out HObject objects, HTuple surrogateTuple )def integer_to_obj( surrogate_tuple: MaybeSequence[int] ) -> HObject

Herror integer_to_obj( Hobject* Objects, const Hlong SurrogateTuple )

Herror T_integer_to_obj( Hobject* Objects, const Htuple SurrogateTuple )

void HObject::IntegerToObj( const HTuple& SurrogateTuple )

void HObject::IntegerToObj( void* SurrogateTuple )

void HObject.IntegerToObj( HTuple surrogateTuple )

void HObject.IntegerToObj( IntPtr surrogateTuple )

Description🔗

integer_to_objIntegerToObj is the inverse operator to obj_to_integerObjToInteger. All surrogates of objects passed in SurrogateTuplesurrogateTuplesurrogate_tuple are stored as objects. In contrast to obj_to_integerObjToInteger, the objects are duplicated. integer_to_objIntegerToObj is intended especially for use in HALCON/C, because iconic objects and control parameters are treated differently in C. Please note that if you pass the value 00 in SurrogateTuplesurrogateTuplesurrogate_tuple, the program will crash because 00 is no valid pointer.

For a short description of the iconic objects that are available in HALCON see the introduction of chapter Object.

Attention🔗

The objects are duplicated in the database.

Execution information🔗

Execution information

  • Supports objects on compute devices.

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Processed without parallelization.

Parameters🔗

Objectsobjectsobjects (output_object) object(-array) → objectHObjectHObjectHObjectHobject *

Created objects.

SurrogateTuplesurrogateTuplesurrogate_tuple (input_control) pointer(-array) → (integer)HTuple (Hlong)HTuple (IntPtr)MaybeSequence[int]Htuple (Hlong)

Tuple of object surrogates.

Result🔗

integer_to_objIntegerToObj returns 2 (H_MSG_TRUE) if all parameters are correct, i.e., if they are valid object keys. If the input is empty the behavior can be set via set_system(::'no_object_result',<Result>:). If necessary, an exception is raised.

Combinations with other operators🔗

Combinations

See also

obj_to_integerObjToInteger

Module🔗

Foundation