insert_objinsert_objInsertObjInsertObj (Operator)

Name

insert_objinsert_objInsertObjInsertObj — Insert objects into an iconic object tuple.

Signature

Description

insert_objinsert_objInsertObjInsertObjInsertObj inserts the elements of ObjectsInsertObjectsInsertObjectsInsertObjectsInsertobjectsInsert at IndexIndexIndexIndexindex into the object tuple ObjectsObjectsObjectsObjectsobjects and returns the result in ObjectsExtendedObjectsExtendedObjectsExtendedObjectsExtendedobjectsExtended.

IndexIndexIndexIndexindex must contain a single integer value. Note that, in contrast to control tuples, indices of object tuple elements start at 1. The length of ObjectsExtendedObjectsExtendedObjectsExtendedObjectsExtendedobjectsExtended is the sum of the length of ObjectsObjectsObjectsObjectsobjects and ObjectsInsertObjectsInsertObjectsInsertObjectsInsertobjectsInsert. It is allowed to mix images, regions and XLDs in ObjectsObjectsObjectsObjectsobjects and ObjectsInsertObjectsInsertObjectsInsertObjectsInsertobjectsInsert.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Example (HDevelop)

gen_image_const (Image1, 'byte', 1, 1)
gen_image_const (Image3, 'byte', 3, 3)
concat_obj (Image1, Image3, Images)
gen_image_const (Image, 'byte', 2, 2)
insert_obj (Images, Image, Images, 2)

Complexity

Typical runtime complexity: O(|ObjectsObjectsObjectsObjectsobjects| + |ObjectsInsertObjectsInsertObjectsInsertObjectsInsertobjectsInsert|).

Possible Predecessors

count_objcount_objCountObjCountObjCountObj

Possible Successors

count_objcount_objCountObjCountObjCountObj

Alternatives

concat_objconcat_objConcatObjConcatObjConcatObj

See also

count_objcount_objCountObjCountObjCountObj, select_objselect_objSelectObjSelectObjSelectObj, copy_objcopy_objCopyObjCopyObjCopyObj, remove_objremove_objRemoveObjRemoveObjRemoveObj

Module

Foundation