replace_objreplace_objReplaceObjReplaceObj (Operator)
Name
replace_objreplace_objReplaceObjReplaceObj
— Ersetzen einzelner Elemente aus inem 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_objReplaceObjReplaceObjReplaceObj
ersetzt einzelne Elemente aus einem ikonischen Objekt-Tupel
ObjectsObjectsObjectsObjectsobjects
und gibt das veränderte Tupel mit dem Parameter
ReplacedReplacedReplacedReplacedreplaced
zurück. Der Parameter IndexIndexIndexIndexindex
enthält hierbei
die Indizes der Elemente und ObjectsReplaceObjectsReplaceObjectsReplaceObjectsReplaceobjectsReplace
die entsprechenden
ikonischen Elementwerte, die ersetzt werden.
Folglich darf IndexIndexIndexIndexindex
ausschließlich ganze Zahlen
beinhalten (falls IndexIndexIndexIndexindex
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 ObjectsReplaceObjectsReplaceObjectsReplaceObjectsReplaceobjectsReplace
nur ein Objekt enthält, dann wird dieses an
allen in IndexIndexIndexIndexindex
angegebenen Indizes eingesetzt. Falls ein Indexwert
größer als die Tupellänge des Eingabeobjektes ist, so wird das Ergebnistupel
ReplacedReplacedReplacedReplacedreplaced
entsprechend verlängert und mit leeren Regionen
aufgefüllt.
Sonderfall: Leere Eingabewerte
Ist einer der beiden Eingabeparameter IndexIndexIndexIndexindex
und ObjectsReplaceObjectsReplaceObjectsReplaceObjectsReplaceobjectsReplace
leer
und das andere nicht, wird eine Fehlermeldung angezeigt. Sind beide leer,
entspricht das Ausgabeobjekt ReplacedReplacedReplacedReplacedreplaced
dem Eingabeobjekt
ObjectsObjectsObjectsObjectsobjects
. Sind beide nicht leer, aber das Eingabeobject ObjectsObjectsObjectsObjectsobjects
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
ObjectsObjectsObjectsObjectsobjects
(input_object) object(-array) →
objectHObjectHObjectHobject
Ikonisches Eingabeobjekt.
ObjectsReplaceObjectsReplaceObjectsReplaceObjectsReplaceobjectsReplace
(input_object) object(-array) →
objectHObjectHObjectHobject
Ikonisches Objekt-Tupel mit den einzusetzenden Elementen.
ReplacedReplacedReplacedReplacedreplaced
(output_object) object(-array) →
objectHObjectHObjectHobject *
Ikonisches Ausgabe-Tupel mit den ersetzten Elementen.
IndexIndexIndexIndexindex
(input_control) number(-array) →
HTupleHTupleHtuple (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_objSelectObjSelectObjSelectObj
Siehe auch
count_objcount_objCountObjCountObjCountObj
,
select_objselect_objSelectObjSelectObjSelectObj
,
copy_objcopy_objCopyObjCopyObjCopyObj
,
insert_objinsert_objInsertObjInsertObjInsertObj
Modul
Foundation