obj_to_integerobj_to_integerObjToIntegerObjToIntegerobj_to_integer (算子名称)
名称
obj_to_integerobj_to_integerObjToIntegerObjToIntegerobj_to_integer — Convert an iconic object into an “integer number.”
参数签名
描述
obj_to_integerobj_to_integerObjToIntegerObjToIntegerObjToIntegerobj_to_integer stores NumberNumberNumberNumbernumbernumber, starting at index
IndexIndexIndexIndexindexindex, of the database keys of the input object
ObjectsObjectsObjectsObjectsobjectsobjects as integer numbers in the output parameter
SurrogateTupleSurrogateTupleSurrogateTupleSurrogateTuplesurrogateTuplesurrogate_tuple. If -1 is passed for NumberNumberNumberNumbernumbernumber all
objects beginning with IndexIndexIndexIndexindexindex are copied. This facilitates
a direct access to an arbitrary element of ObjectsObjectsObjectsObjectsobjectsobjects. In
conjunction with count_objcount_objCountObjCountObjCountObjcount_obj (returns the number of objects in
ObjectsObjectsObjectsObjectsobjectsobjects) the elements of ObjectsObjectsObjectsObjectsobjectsobjects can be processed
successively. The objects are not duplicated by
obj_to_integerobj_to_integerObjToIntegerObjToIntegerObjToIntegerobj_to_integer and thus must not be cleared by
clear_objclear_objClearObjClearObjClearObjclear_obj.
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.
运行信息
- Supports objects on compute devices.
- 多线程类型:可重入(与非独占操作符并行运行)。
- 多线程作用域:全局(可以从任何线程调用)。
- 未经并行化处理。
参数表
ObjectsObjectsObjectsObjectsobjectsobjects (input_object) object(-array) → objectHObjectHObjectHObjectHobject
Objects for which the surrogates are to be returned.
IndexIndexIndexIndexindexindex (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Starting index of the surrogates to be returned.
Default:
1
Value range:
1
≤
Index
Index
Index
Index
index
index
NumberNumberNumberNumbernumbernumber (input_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Number of surrogates to be returned.
Default:
-1
Restriction:
Number == -1 || Number + Index <= number(Objects)
SurrogateTupleSurrogateTupleSurrogateTupleSurrogateTuplesurrogateTuplesurrogate_tuple (output_control) pointer(-array) → HTupleSequence[int]HTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)
Tuple containing the surrogates.
例程 (HDevelop)
* Access the i-th element:
obj_to_integer(Objects,i,1,Surrogat)
例程 (C)
/* Access the i-th element: */
Hlong i,Surrogate;
obj_to_integer(Objects,i,1,&Surrogat);
例程 (HDevelop)
* Access the i-th element:
obj_to_integer(Objects,i,1,Surrogat)
例程 (HDevelop)
* Access the i-th element:
obj_to_integer(Objects,i,1,Surrogat)
例程 (HDevelop)
* Access the i-th element:
obj_to_integer(Objects,i,1,Surrogat)
Complexity
Runtime complexity: O(|ObjectsObjectsObjectsObjectsobjectsobjects| + NumberNumberNumberNumbernumbernumber)
结果
obj_to_integerobj_to_integerObjToIntegerObjToIntegerObjToIntegerobj_to_integer 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>)set_system("no_object_result",<Result>).
如有必要，将引发异常。
可替代算子
copy_objcopy_objCopyObjCopyObjCopyObjcopy_obj,
select_objselect_objSelectObjSelectObjSelectObjselect_obj,
copy_imagecopy_imageCopyImageCopyImageCopyImagecopy_image,
gen_image_protogen_image_protoGenImageProtoGenImageProtoGenImageProtogen_image_proto
参考其它
integer_to_objinteger_to_objIntegerToObjIntegerToObjIntegerToObjinteger_to_obj,
count_objcount_objCountObjCountObjCountObjcount_obj
模块
Foundation