replace_objreplace_objReplaceObjReplaceObjreplace_obj (Operator)
Name
replace_objreplace_objReplaceObjReplaceObjreplace_obj — Ersetzen einzelner Elemente aus einem ikonischen Objekt-Tupel.
Signatur
void ReplaceObj(const HObject& Objects, const HObject& ObjectsReplace, HObject* Replaced, const HTuple& Index)
HObject HObject::ReplaceObj(const HObject& ObjectsReplace, const HTuple& Index) const
HObject HObject::ReplaceObj(const HObject& ObjectsReplace, Hlong Index) const
HImage HImage::ReplaceObj(const HImage& ObjectsReplace, const HTuple& Index) const
HImage HImage::ReplaceObj(const HImage& ObjectsReplace, Hlong Index) const
HRegion HRegion::ReplaceObj(const HRegion& ObjectsReplace, const HTuple& Index) const
HRegion HRegion::ReplaceObj(const HRegion& ObjectsReplace, Hlong Index) const
HXLD HXLD::ReplaceObj(const HXLD& ObjectsReplace, const HTuple& Index) const
HXLD HXLD::ReplaceObj(const HXLD& ObjectsReplace, Hlong Index) const
HXLDCont HXLDCont::ReplaceObj(const HXLDCont& ObjectsReplace, const HTuple& Index) const
HXLDCont HXLDCont::ReplaceObj(const HXLDCont& ObjectsReplace, Hlong Index) const
HXLDPoly HXLDPoly::ReplaceObj(const HXLDPoly& ObjectsReplace, const HTuple& Index) const
HXLDPoly HXLDPoly::ReplaceObj(const HXLDPoly& ObjectsReplace, Hlong Index) const
HXLDPara HXLDPara::ReplaceObj(const HXLDPara& ObjectsReplace, const HTuple& Index) const
HXLDPara HXLDPara::ReplaceObj(const HXLDPara& ObjectsReplace, Hlong Index) const
HXLDModPara HXLDModPara::ReplaceObj(const HXLDModPara& ObjectsReplace, const HTuple& Index) const
HXLDModPara HXLDModPara::ReplaceObj(const HXLDModPara& ObjectsReplace, Hlong Index) const
HXLDExtPara HXLDExtPara::ReplaceObj(const HXLDExtPara& ObjectsReplace, const HTuple& Index) const
HXLDExtPara HXLDExtPara::ReplaceObj(const HXLDExtPara& ObjectsReplace, Hlong Index) const
static void HOperatorSet.ReplaceObj(HObject objects, HObject objectsReplace, out HObject replaced, HTuple index)
HObject HObject.ReplaceObj(HObject objectsReplace, HTuple index)
HObject HObject.ReplaceObj(HObject objectsReplace, int index)
HImage HImage.ReplaceObj(HImage objectsReplace, HTuple index)
HImage HImage.ReplaceObj(HImage objectsReplace, int index)
HRegion HRegion.ReplaceObj(HRegion objectsReplace, HTuple index)
HRegion HRegion.ReplaceObj(HRegion objectsReplace, int index)
HXLD HXLD.ReplaceObj(HXLD objectsReplace, HTuple index)
HXLD HXLD.ReplaceObj(HXLD objectsReplace, int index)
HXLDCont HXLDCont.ReplaceObj(HXLDCont objectsReplace, HTuple index)
HXLDCont HXLDCont.ReplaceObj(HXLDCont objectsReplace, int index)
HXLDPoly HXLDPoly.ReplaceObj(HXLDPoly objectsReplace, HTuple index)
HXLDPoly HXLDPoly.ReplaceObj(HXLDPoly objectsReplace, int index)
HXLDPara HXLDPara.ReplaceObj(HXLDPara objectsReplace, HTuple index)
HXLDPara HXLDPara.ReplaceObj(HXLDPara objectsReplace, int index)
HXLDModPara HXLDModPara.ReplaceObj(HXLDModPara objectsReplace, HTuple index)
HXLDModPara HXLDModPara.ReplaceObj(HXLDModPara objectsReplace, int index)
HXLDExtPara HXLDExtPara.ReplaceObj(HXLDExtPara objectsReplace, HTuple index)
HXLDExtPara HXLDExtPara.ReplaceObj(HXLDExtPara objectsReplace, int index)
Beschreibung
replace_objreplace_objReplaceObjReplaceObjReplaceObjreplace_obj ersetzt einzelne Elemente aus einem ikonischen Objekt-Tupel
ObjectsObjectsObjectsObjectsobjectsobjects und gibt das veränderte Tupel mit dem Parameter
ReplacedReplacedReplacedReplacedreplacedreplaced zurück. Der Parameter IndexIndexIndexIndexindexindex enthält hierbei
die Indizes der Elemente und ObjectsReplaceObjectsReplaceObjectsReplaceObjectsReplaceobjectsReplaceobjects_replace die entsprechenden
ikonischen Elementwerte, die ersetzt werden.
Folglich darf IndexIndexIndexIndexindexindex ausschließlich ganze Zahlen
beinhalten (falls IndexIndexIndexIndexindexindex eine Gleitkommazahl enthält, so
muss diese eine ganze Zahl repräsentieren; alle Nachkommastellen der
Zahl müssen also 0 sein). Ikonische Tupelindizes werden beginnend mit 1
gezählt, das heißt das erste Tupelelement wird über den Index 1 ausgewählt.
Falls ObjectsReplaceObjectsReplaceObjectsReplaceObjectsReplaceobjectsReplaceobjects_replace nur ein Objekt enthält, dann wird dieses an
allen in IndexIndexIndexIndexindexindex angegebenen Indizes eingesetzt. Falls ein Indexwert
größer als die Tupellänge des Eingabeobjektes ist, so wird das Ergebnistupel
ReplacedReplacedReplacedReplacedreplacedreplaced entsprechend verlängert und mit leeren Regionen
aufgefüllt.
Sonderfall: Leere Eingabewerte
Ist einer der beiden Eingabeparameter IndexIndexIndexIndexindexindex und ObjectsReplaceObjectsReplaceObjectsReplaceObjectsReplaceobjectsReplaceobjects_replace leer
und das andere nicht, wird eine Fehlermeldung angezeigt. Sind beide leer,
entspricht das Ausgabeobjekt ReplacedReplacedReplacedReplacedreplacedreplaced dem Eingabeobjekt
ObjectsObjectsObjectsObjectsobjectsobjects. Sind beide nicht leer, aber das Eingabeobjekt ObjectsObjectsObjectsObjectsobjectsobjects
ist leer, wird das leere Objekt entsprechend der oben beschriebenen
Vorgehensweise erweitert.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
ObjectsObjectsObjectsObjectsobjectsobjects (input_object) object(-array) → objectHObjectHObjectHObjectHobject
Ikonisches Eingabeobjekt.
ObjectsReplaceObjectsReplaceObjectsReplaceObjectsReplaceobjectsReplaceobjects_replace (input_object) object(-array) → objectHObjectHObjectHObjectHobject
Ikonisches Objekt-Tupel mit den einzusetzenden Elementen.
ReplacedReplacedReplacedReplacedreplacedreplaced (output_object) object(-array) → objectHObjectHObjectHObjectHobject *
Ikonisches Ausgabe-Tupel mit den ersetzten Elementen.
IndexIndexIndexIndexindexindex (input_control) number(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Indizes der zu ersetzenden Elemente.
Beispiel (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)
Alternativen
select_objselect_objSelectObjSelectObjSelectObjselect_obj
Siehe auch
count_objcount_objCountObjCountObjCountObjcount_obj,
select_objselect_objSelectObjSelectObjSelectObjselect_obj,
copy_objcopy_objCopyObjCopyObjCopyObjcopy_obj,
insert_objinsert_objInsertObjInsertObjInsertObjinsert_obj
Modul
Foundation