replace_objreplace_objReplaceObjReplaceObjreplace_obj (算子)

名称

replace_objreplace_objReplaceObjReplaceObjreplace_obj — 替换图标对象元组的一个或多个元素。

签名

replace_obj(Objects, ObjectsReplace : Replaced : Index : )

描述

replace_objreplace_objReplaceObjReplaceObjReplaceObjreplace_obj replaces one or more elements of the iconic input tuple ObjectsObjectsObjectsObjectsobjectsobjects and returns them with ReplacedReplacedReplacedReplacedreplacedreplaced. At this, IndexIndexIndexIndexindexindex determines the indices of the elements and ObjectsReplaceObjectsReplaceObjectsReplaceObjectsReplaceobjectsReplaceobjects_replace the corresponding objects to replace. The parameter IndexIndexIndexIndexindexindex must contain one or more integer values (any floating point number must represent an integer value without fraction). Indices of iconic object elements start at 1. If ObjectsReplaceObjectsReplaceObjectsReplaceObjectsReplaceobjectsReplaceobjects_replace contains only one value, this value will be replaced at all indices of IndexIndexIndexIndexindexindex. If a value of IndexIndexIndexIndexindexindex is greater than the length of the iconic input object tuple ObjectsObjectsObjectsObjectsobjectsobjects, ReplacedReplacedReplacedReplacedreplacedreplaced will be extended accordingly and initialized with empty regions.

Exception: Empty input object

If either IndexIndexIndexIndexindexindex or ObjectsReplaceObjectsReplaceObjectsReplaceObjectsReplaceobjectsReplaceobjects_replace is empty and the other is not, an exception is raised. If both are empty, the output object tuple ReplacedReplacedReplacedReplacedreplacedreplaced corresponds to the input ObjectsObjectsObjectsObjectsobjectsobjects. If both are not empty, but the input ObjectsObjectsObjectsObjectsobjectsobjects is, the empty object will be extended as described above.

执行信息

多线程类型：可重入（与非独占算子并行运行）。
多线程作用域：全局（可从任何线程调用）。
未采用并行化处理。

参数

ObjectsObjectsObjectsObjectsobjectsobjects (输入对象) object(-array) → object

Iconic Input Object.

ObjectsReplaceObjectsReplaceObjectsReplaceObjectsReplaceobjectsReplaceobjects_replace (输入对象) object(-array) → object

Element(s) to replace.

ReplacedReplacedReplacedReplacedreplacedreplaced (输出对象) object(-array) → object

Tuple with replaced elements.

IndexIndexIndexIndexindexindex (输入控制) number(-array) → (integer)

Index/Indices of elements to be replaced.

示例（HDevelop）

gen_empty_obj (Images)
for Index := 1 to 10 by 1
  gen_image_const (Image, 'byte', Index, Index)
  concat_obj (Images, Image, Images)
endfor
gen_empty_obj (Replace)

replace_obj (Images, Replace, Images, 1)

替代

select_objselect_objSelectObjSelectObjSelectObjselect_obj

另见

count_objcount_objCountObjCountObjCountObjcount_obj, select_objselect_objSelectObjSelectObjSelectObjselect_obj, copy_objcopy_objCopyObjCopyObjCopyObjcopy_obj, insert_objinsert_objInsertObjInsertObjInsertObjinsert_obj

模块

基础

算子