Operator Reference

remove_objremove_objRemoveObjRemoveObjremove_obj (Operator)

remove_objremove_objRemoveObjRemoveObjremove_obj — Remove objects from an iconic object tuple.

Signature

remove_obj(Objects : ObjectsReduced : Index : )

Description

remove_objremove_objRemoveObjRemoveObjremove_obj removes the elements referred by IndexIndexIndexindexindex from the tuple ObjectsObjectsObjectsobjectsobjects and returns the rest in the tuple ObjectsReducedObjectsReducedObjectsReducedobjectsReducedobjects_reduced. IndexIndexIndexindexindex determines the index of the elements to remove. Note that, in contrast to control tuples, indices for the object tuple elements start at 1, i.e. the first tuple element has got the index 1. Duplicates and indices out of range are ignored.

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

ObjectsObjectsObjectsobjectsobjects (input_object) object(-array) → object

Input object tuple.

ObjectsReducedObjectsReducedObjectsReducedobjectsReducedobjects_reduced (output_object) object(-array) → object

Remaining object tuple.

IndexIndexIndexindexindex (input_control) number(-array) → (integer)

Indices of the objects to be removed.

Example (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

remove_obj (Images, Images, [7, 4])

Alternatives

select_objselect_objSelectObjSelectObjselect_obj

Module

Foundation

Operators