tuple_select_masktuple_select_maskTupleSelectMaskTupleSelectMask (Operator)

Name

tuple_select_masktuple_select_maskTupleSelectMaskTupleSelectMask — Auswählen einzelner Elemente aus einem Tupel anhand einer Maske.

Signatur

tuple_select_mask( : : Tuple, Mask : Selected)

Beschreibung

tuple_select_masktuple_select_maskTupleSelectMaskTupleSelectMaskTupleSelectMask wählt einzelne Elemente aus einem Tupel TupleTupleTupleTupletuple aus und gibt sie mit dem Parameter SelectedSelectedSelectedSelectedselected zurück. Der Parameter MaskMaskMaskMaskmask legt für jedes Element fest, ob es ausgewählt wird. Ist der Wert größer als 0, so wird das entsprechende Element in SelectedSelectedSelectedSelectedselected übernommen. Folgerichtig darf MaskMaskMaskMaskmask ausschließlich Zahlen beinhalten und muss die gleiche Länge wie TupleTupleTupleTupletuple 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_maskTupleSelectMaskTupleSelectMaskTupleSelectMask, 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

TupleTupleTupleTupletuple (input_control) tuple(-array) → (integer / real / string)

Eingabetupel.

MaskMaskMaskMaskmask (input_control) integer(-array) → (integer)

Spezifiziert jeweils mit >0 die auszuwählenden Elemente.

SelectedSelectedSelectedSelectedselected (output_control) tuple(-array) → (integer / real / string)

Ausgewählte Tupelelemente.

Alternativen

tuple_first_ntuple_first_nTupleFirstNTupleFirstNTupleFirstN, tuple_last_ntuple_last_nTupleLastNTupleLastNTupleLastN, tuple_str_bit_selecttuple_str_bit_selectTupleStrBitSelectTupleStrBitSelectTupleStrBitSelect, tuple_concattuple_concatTupleConcatTupleConcatTupleConcat, tuple_selecttuple_selectTupleSelectTupleSelectTupleSelect, tuple_select_rangetuple_select_rangeTupleSelectRangeTupleSelectRangeTupleSelectRange, tuple_select_ranktuple_select_rankTupleSelectRankTupleSelectRankTupleSelectRank

Siehe auch

tuple_removetuple_removeTupleRemoveTupleRemoveTupleRemove

Modul

Foundation

Operatoren