integer_to_objinteger_to_objinteger_to_objIntegerToObjIntegerToObj (Operator)

Name

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

Signature

Description

integer_to_objinteger_to_objinteger_to_objIntegerToObjIntegerToObj is the inverse operator to obj_to_integerobj_to_integerobj_to_integerObjToIntegerObjToInteger. All surrogates of objects passed in SurrogateTupleSurrogateTupleSurrogateTupleSurrogateTuplesurrogateTuple are stored as objects. In contrast to obj_to_integerobj_to_integerobj_to_integerObjToIntegerObjToInteger, the objects are duplicated. integer_to_objinteger_to_objinteger_to_objIntegerToObjIntegerToObj 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 0 in SurrogateTupleSurrogateTupleSurrogateTupleSurrogateTuplesurrogateTuple, the program will crash because 0 is no valid pointer.

Attention

The objects are duplicated in the database.

Parallelization

• 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

Result

integer_to_objinteger_to_objinteger_to_objIntegerToObjIntegerToObj 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>:)set_system("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

See also

obj_to_integerobj_to_integerobj_to_integerObjToIntegerObjToInteger

Module

Foundation