tuple_select_masktuple_select_maskTupleSelectMaskTupleSelectMasktuple_select_mask (Operator)
Name
tuple_select_masktuple_select_maskTupleSelectMaskTupleSelectMasktuple_select_mask — Auswählen einzelner Elemente aus einem Tupel anhand einer Maske.
Signatur
def tuple_select_mask(tuple: MaybeSequence[Union[float, int, str]], mask: MaybeSequence[int]) -> Sequence[Union[float, int, str]]
def tuple_select_mask_s(tuple: MaybeSequence[Union[float, int, str]], mask: MaybeSequence[int]) -> Union[float, int, str]
Beschreibung
tuple_select_masktuple_select_maskTupleSelectMaskTupleSelectMaskTupleSelectMasktuple_select_mask wählt einzelne Elemente aus einem Tupel
TupleTupleTupleTupletupletuple aus und gibt sie mit dem Parameter SelectedSelectedSelectedSelectedselectedselected
zurück. Der Parameter MaskMaskMaskMaskmaskmask legt für jedes Element fest,
ob es ausgewählt wird. Ist der Wert größer als 0, so wird das
entsprechende Element in SelectedSelectedSelectedSelectedselectedselected übernommen.
Folgerichtig darf MaskMaskMaskMaskmaskmask ausschließlich Zahlen beinhalten
und muss die gleiche Länge wie TupleTupleTupleTupletupletuple haben.
Sonderfall: Leere Eingabetupel
Falls beide Eingabetupel leer sind, gibt der Operator ein leeres Tupel
zurück. Falls nur eins der Eingabetupel leer ist und das andere nicht,
wird eine Fehlermeldung angezeigt.
HDevelop Inline-Operation
HDevelop unterstützt eine Inline-Operation für tuple_select_masktuple_select_maskTupleSelectMaskTupleSelectMaskTupleSelectMasktuple_select_mask,
die innerhalb eines Ausdrucks in der folgenden Syntax verwendet werden
kann:
Selected := select_mask(Tuple, Mask)
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.
MaskMaskMaskMaskmaskmask (input_control) integer(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Spezifiziert jeweils mit >0 die auszuwählenden Elemente.
SelectedSelectedSelectedSelectedselectedselected (output_control) tuple(-array) → HTupleSequence[Union[float, int, str]]HTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Ausgewählte Tupelelemente.
Alternativen
tuple_first_ntuple_first_nTupleFirstNTupleFirstNTupleFirstNtuple_first_n,
tuple_last_ntuple_last_nTupleLastNTupleLastNTupleLastNtuple_last_n,
tuple_str_bit_selecttuple_str_bit_selectTupleStrBitSelectTupleStrBitSelectTupleStrBitSelecttuple_str_bit_select,
tuple_concattuple_concatTupleConcatTupleConcatTupleConcattuple_concat,
tuple_selecttuple_selectTupleSelectTupleSelectTupleSelecttuple_select,
tuple_select_rangetuple_select_rangeTupleSelectRangeTupleSelectRangeTupleSelectRangetuple_select_range,
tuple_select_ranktuple_select_rankTupleSelectRankTupleSelectRankTupleSelectRanktuple_select_rank
Siehe auch
tuple_removetuple_removeTupleRemoveTupleRemoveTupleRemovetuple_remove
Modul
Foundation