KlassenKlassenKlassenKlassen | | | | Operatoren

tuple_replaceT_tuple_replaceTupleReplacetuple_replaceTupleReplaceTupleReplace (Operator)

Name

tuple_replaceT_tuple_replaceTupleReplacetuple_replaceTupleReplaceTupleReplace — Ersetzen einzelner Elemente aus einem Tupel.

Signatur

tuple_replace( : : Tuple, Index, ReplaceTuple : Replaced)

Herror T_tuple_replace(const Htuple Tuple, const Htuple Index, const Htuple ReplaceTuple, Htuple* Replaced)

Herror tuple_replace(const HTuple& Tuple, const HTuple& Index, const HTuple& ReplaceTuple, HTuple* Replaced)

void TupleReplace(const HTuple& Tuple, const HTuple& Index, const HTuple& ReplaceTuple, HTuple* Replaced)

HTuple HTuple::TupleReplace(const HTuple& Index, const HTuple& ReplaceTuple) const

void HOperatorSetX.TupleReplace(
[in] VARIANT Tuple, [in] VARIANT Index, [in] VARIANT ReplaceTuple, [out] VARIANT* Replaced)

VARIANT HTupleX.TupleReplace(
[in] VARIANT Tuple, [in] VARIANT Index, [in] VARIANT ReplaceTuple)

static void HOperatorSet.TupleReplace(HTuple tuple, HTuple index, HTuple replaceTuple, out HTuple replaced)

HTuple HTuple.TupleReplace(HTuple index, HTuple replaceTuple)

Beschreibung

tuple_replacetuple_replaceTupleReplacetuple_replaceTupleReplaceTupleReplace ersetzt einzelne Elemente aus einem Tupel TupleTupleTupleTupleTupletuple und gibt das veränderte Tupel mit dem Parameter ReplacedReplacedReplacedReplacedReplacedreplaced zurück. Der Parameter IndexIndexIndexIndexIndexindex enthält hierbei die Indizes der Elemente und ReplaceTupleReplaceTupleReplaceTupleReplaceTupleReplaceTuplereplaceTuple die entsprechenden 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). Tupelindizes werden beginnend mit 0 gezählt, das heißt das erste Tupelelement wird über den Index 0 ausgewählt. Falls ReplaceTupleReplaceTupleReplaceTupleReplaceTupleReplaceTuplereplaceTuple nur einen Wert enthält, dann wird dieser an allen in IndexIndexIndexIndexIndexindex angegebenen Indizes eingesetzt. Falls ein Indexwert größer als die bisherige Tupellänge ist, so wird das Ergebnistupel ReplacedReplacedReplacedReplacedReplacedreplaced entsprechend verlängert und mit Nullen aufgefüllt. Falls zum Beispiel TupleTupleTupleTupleTupletuple [1] enthält, IndexIndexIndexIndexIndexindex die Werte [2,4] enthält und ReplaceTupleReplaceTupleReplaceTupleReplaceTupleReplaceTuplereplaceTuple die Werte [3,5] enthält, so ergibt sich ReplacedReplacedReplacedReplacedReplacedreplaced gleich [1,0,3,0,5].

Die Eingabetupel TupleTupleTupleTupleTupletuple und ReplaceTupleReplaceTupleReplaceTupleReplaceTupleReplaceTuplereplaceTuple dürfen gleichzeitig Strings und Zahlen enthalten.

Sonderfall: Leere Eingabetupel

Ist eines der beiden Tupel IndexIndexIndexIndexIndexindex und ReplaceTupleReplaceTupleReplaceTupleReplaceTupleReplaceTuplereplaceTuple leer und das andere nicht, wird eine Fehlermeldung angezeigt. Sind beide leer, entspricht das Ausgabetupel ReplacedReplacedReplacedReplacedReplacedreplaced dem Eingabetupel TupleTupleTupleTupleTupletuple. Sind beide nicht leer, aber das Eingabetuple TupleTupleTupleTupleTupletuple ist leer, wird das leere Tupel entsprechend der oben beschriebenen Vorgehensweise erweitert.

HDevelop Inline-Operation

HDevelop unterstützt eine Inline-Operation für tuple_replacetuple_replaceTupleReplacetuple_replaceTupleReplaceTupleReplace, die innerhalb eines Ausdrucks in der folgenden Syntax verwendet werden kann:

Replaced := replace(Tuple, Index, ReplaceTuple)

Parallelisierung

Parameter

TupleTupleTupleTupleTupletuple (input_control)  number(-array) HTupleHTupleHTupleVARIANTHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*) (Hlong / double / BSTR) (Hlong / double / char*)

Eingabetupel.

IndexIndexIndexIndexIndexindex (input_control)  number(-array) HTupleHTupleHTupleVARIANTHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double) (Hlong / double) (Hlong / double)

Indizes der zu ersetzenden Elemente.

ReplaceTupleReplaceTupleReplaceTupleReplaceTupleReplaceTuplereplaceTuple (input_control)  number(-array) HTupleHTupleHTupleVARIANTHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*) (Hlong / double / BSTR) (Hlong / double / char*)

Tupel mit den einzusetzenden Elementen.

ReplacedReplacedReplacedReplacedReplacedreplaced (output_control)  number-array HTupleHTupleHTupleVARIANTHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*) (Hlong / double / BSTR) (Hlong / double / char*)

Tupel mit den ersetzten Elementen.

Alternativen

tuple_selecttuple_selectTupleSelecttuple_selectTupleSelectTupleSelect, tuple_first_ntuple_first_nTupleFirstNtuple_first_nTupleFirstNTupleFirstN, tuple_last_ntuple_last_nTupleLastNtuple_last_nTupleLastNTupleLastN, tuple_select_masktuple_select_maskTupleSelectMasktuple_select_maskTupleSelectMaskTupleSelectMask, tuple_str_bit_selecttuple_str_bit_selectTupleStrBitSelecttuple_str_bit_selectTupleStrBitSelectTupleStrBitSelect, tuple_concattuple_concatTupleConcattuple_concatTupleConcatTupleConcat, tuple_select_ranktuple_select_rankTupleSelectRanktuple_select_rankTupleSelectRankTupleSelectRank

Siehe auch

tuple_removetuple_removeTupleRemovetuple_removeTupleRemoveTupleRemove, tuple_inserttuple_insertTupleInserttuple_insertTupleInsertTupleInsert

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren