obj_to_integerobj_to_integerObjToIntegerObjToInteger (Operator)

Name

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

obj_to_integerobj_to_integerObjToIntegerObjToIntegerObjToInteger stores NumberNumberNumberNumbernumber, starting at index IndexIndexIndexIndexindex, of the database keys of the input object ObjectsObjectsObjectsObjectsobjects as integer numbers in the output parameter SurrogateTupleSurrogateTupleSurrogateTupleSurrogateTuplesurrogateTuple. If -1 is passed for NumberNumberNumberNumbernumber all objects beginning with IndexIndexIndexIndexindex are copied. This facilitates a direct access to an arbitrary element of ObjectsObjectsObjectsObjectsobjects. In conjunction with count_objcount_objCountObjCountObjCountObj (returns the number of objects in ObjectsObjectsObjectsObjectsobjects) the elements of ObjectsObjectsObjectsObjectsobjects can be processed successively. The objects are not duplicated by obj_to_integerobj_to_integerObjToIntegerObjToIntegerObjToInteger and thus must not be cleared by clear_objclear_objClearObjClearObjClearObj.

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

The objects' data is not duplicated.

ObjectsObjectsObjectsObjectsobjects (input_object) object(-array) → object

Objects for which the surrogates are to be returned.

IndexIndexIndexIndexindex (input_control) integer → (integer)

Starting index of the surrogates to be returned.

Default value: 1

Typical range of values: 1 ≤ Index Index Index Index index

NumberNumberNumberNumbernumber (input_control) integer → (integer)

Number of surrogates to be returned.

Default value: -1

Restriction: Number == -1 || Number + Index <= number(Objects)

Tuple containing the surrogates.

* Access the i-th element:
obj_to_integer(Objects,i,1,Surrogat)

/* Access the i-th element: */
Hlong i,Surrogate;
obj_to_integer(Objects,i,1,&Surrogat);

* Access the i-th element:
obj_to_integer(Objects,i,1,Surrogat)

* Access the i-th element:
obj_to_integer(Objects,i,1,Surrogat)

* Access the i-th element:
obj_to_integer(Objects,i,1,Surrogat)

obj_to_integerobj_to_integerObjToIntegerObjToIntegerObjToInteger returns 2 (H_MSG_TRUE) if all parameters are correct. If the input is empty the behavior can be set via set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

Foundation