insert_objinsert_objInsertObjInsertObj (Operator)

Name

insert_objinsert_objInsertObjInsertObj — Insert objects into an iconic object tuple.

Signature

insert_obj(Objects, ObjectsInsert : ObjectsExtended : Index : )

Herror insert_obj(const Hobject Objects, const Hobject ObjectsInsert, Hobject* ObjectsExtended, const Hlong Index)

Herror T_insert_obj(const Hobject Objects, const Hobject ObjectsInsert, Hobject* ObjectsExtended, const Htuple Index)

void InsertObj(const HObject& Objects, const HObject& ObjectsInsert, HObject* ObjectsExtended, const HTuple& Index)

HObject HObject::InsertObj(const HObject& ObjectsInsert, Hlong Index) const

HImage HImage::InsertObj(const HImage& ObjectsInsert, Hlong Index) const

HRegion HRegion::InsertObj(const HRegion& ObjectsInsert, Hlong Index) const

HXLD HXLD::InsertObj(const HXLD& ObjectsInsert, Hlong Index) const

HXLDCont HXLDCont::InsertObj(const HXLDCont& ObjectsInsert, Hlong Index) const

HXLDPoly HXLDPoly::InsertObj(const HXLDPoly& ObjectsInsert, Hlong Index) const

HXLDPara HXLDPara::InsertObj(const HXLDPara& ObjectsInsert, Hlong Index) const

HXLDModPara HXLDModPara::InsertObj(const HXLDModPara& ObjectsInsert, Hlong Index) const

HXLDExtPara HXLDExtPara::InsertObj(const HXLDExtPara& ObjectsInsert, Hlong Index) const

static void HOperatorSet.InsertObj(HObject objects, HObject objectsInsert, out HObject objectsExtended, HTuple index)

HObject HObject.InsertObj(HObject objectsInsert, int index)

HImage HImage.InsertObj(HImage objectsInsert, int index)

HRegion HRegion.InsertObj(HRegion objectsInsert, int index)

HXLD HXLD.InsertObj(HXLD objectsInsert, int index)

HXLDCont HXLDCont.InsertObj(HXLDCont objectsInsert, int index)

HXLDPoly HXLDPoly.InsertObj(HXLDPoly objectsInsert, int index)

HXLDPara HXLDPara.InsertObj(HXLDPara objectsInsert, int index)

HXLDModPara HXLDModPara.InsertObj(HXLDModPara objectsInsert, int index)

HXLDExtPara HXLDExtPara.InsertObj(HXLDExtPara objectsInsert, int index)

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

Parameters

ObjectsObjectsObjectsObjectsobjects (input_object)  object(-array) objectHObjectHObjectHobject

Input object tuple.

ObjectsInsertObjectsInsertObjectsInsertObjectsInsertobjectsInsert (input_object)  object(-array) objectHObjectHObjectHobject

Object tuple to insert.

ObjectsExtendedObjectsExtendedObjectsExtendedObjectsExtendedobjectsExtended (output_object)  object(-array) objectHObjectHObjectHobject *

Extended object tuple.

IndexIndexIndexIndexindex (input_control)  number HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Index to insert objects.

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