tuple_replaceT_tuple_replaceTupleReplaceTupleReplacetuple_replace (Operator)
Name
tuple_replaceT_tuple_replaceTupleReplaceTupleReplacetuple_replace — Ersetzen einzelner Elemente aus einem Tupel.
Signatur
def tuple_replace(tuple: MaybeSequence[Union[float, int, str]], index: MaybeSequence[int], replace_tuple: MaybeSequence[Union[float, int, str]]) -> Sequence[Union[float, int, str]]
Beschreibung
tuple_replacetuple_replaceTupleReplaceTupleReplaceTupleReplacetuple_replace 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 ReplaceTupleReplaceTupleReplaceTupleReplaceTuplereplaceTuplereplace_tuple 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 ReplaceTupleReplaceTupleReplaceTupleReplaceTuplereplaceTuplereplace_tuple 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 ReplaceTupleReplaceTupleReplaceTupleReplaceTuplereplaceTuplereplace_tuple die Werte
[3,5] enthält, so ergibt sich ReplacedReplacedReplacedReplacedreplacedreplaced gleich [1,0,3,0,5].
Die Eingabetupel TupleTupleTupleTupletupletuple und ReplaceTupleReplaceTupleReplaceTupleReplaceTuplereplaceTuplereplace_tuple dürfen
gleichzeitig Strings und Zahlen enthalten.
Sonderfall: Leere Eingabetupel
Ist eines der beiden Tupel IndexIndexIndexIndexindexindex und ReplaceTupleReplaceTupleReplaceTupleReplaceTuplereplaceTuplereplace_tuple 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 Eingabetupel 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_replaceTupleReplaceTupleReplaceTupleReplacetuple_replace,
die innerhalb eines Ausdrucks in der folgenden Syntax verwendet werden
kann:
Replaced := replace(Tuple, Index, ReplaceTuple)
Ausführungsinformationen
- Multithreading-Typ: independent (läuft parallel auch zu exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
TupleTupleTupleTupletupletuple (input_control) tuple(-array) → HTupleMaybeSequence[Union[float, int, str]]HTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Eingabetupel.
IndexIndexIndexIndexindexindex (input_control) integer(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Indizes der zu ersetzenden Elemente.
ReplaceTupleReplaceTupleReplaceTupleReplaceTuplereplaceTuplereplace_tuple (input_control) tuple(-array) → HTupleMaybeSequence[Union[float, int, str]]HTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Tupel mit den einzusetzenden Elementen.
ReplacedReplacedReplacedReplacedreplacedreplaced (output_control) tuple-array → HTupleSequence[Union[float, int, str]]HTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Tupel mit den ersetzten Elementen.
Alternativen
tuple_selecttuple_selectTupleSelectTupleSelectTupleSelecttuple_select,
tuple_first_ntuple_first_nTupleFirstNTupleFirstNTupleFirstNtuple_first_n,
tuple_last_ntuple_last_nTupleLastNTupleLastNTupleLastNtuple_last_n,
tuple_select_masktuple_select_maskTupleSelectMaskTupleSelectMaskTupleSelectMasktuple_select_mask,
tuple_str_bit_selecttuple_str_bit_selectTupleStrBitSelectTupleStrBitSelectTupleStrBitSelecttuple_str_bit_select,
tuple_concattuple_concatTupleConcatTupleConcatTupleConcattuple_concat,
tuple_select_ranktuple_select_rankTupleSelectRankTupleSelectRankTupleSelectRanktuple_select_rank
Siehe auch
tuple_removetuple_removeTupleRemoveTupleRemoveTupleRemovetuple_remove,
tuple_inserttuple_insertTupleInsertTupleInsertTupleInserttuple_insert
Modul
Foundation