HALCON Website / HALCON Operator-Referenz / Tupel / Elementauswahl
KlassenKlassenKlassenKlassen | | | | Operatoren

tuple_select_masktuple_select_maskTupleSelectMasktuple_select_maskTupleSelectMaskTupleSelectMask (Operator)

Name

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

Signatur

tuple_select_mask( : : Tuple, Mask : Selected)

Herror tuple_select_mask(const Hlong Tuple, const Hlong Mask, Hlong* Selected)

Herror T_tuple_select_mask(const Htuple Tuple, const Htuple Mask, Htuple* Selected)

Herror tuple_select_mask(const HTuple& Tuple, const HTuple& Mask, Hlong* Selected)

Herror tuple_select_mask(const HTuple& Tuple, const HTuple& Mask, HTuple* Selected)

void TupleSelectMask(const HTuple& Tuple, const HTuple& Mask, HTuple* Selected)

HTuple HTuple::TupleSelectMask(const HTuple& Mask) const

void HOperatorSetX.TupleSelectMask(
[in] VARIANT Tuple, [in] VARIANT Mask, [out] VARIANT* Selected)

VARIANT HTupleX.TupleSelectMask(
[in] VARIANT Tuple, [in] VARIANT Mask)

static void HOperatorSet.TupleSelectMask(HTuple tuple, HTuple mask, out HTuple selected)

HTuple HTuple.TupleSelectMask(HTuple mask)

Beschreibung

tuple_select_masktuple_select_maskTupleSelectMasktuple_select_maskTupleSelectMaskTupleSelectMask 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_maskTupleSelectMasktuple_select_maskTupleSelectMaskTupleSelectMask, die innerhalb eines Ausdrucks in der folgenden Syntax verwendet werden kann:

Selected := select_mask(Tuple, Mask)

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.

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

Spezifiziert jeweils mit >0 die auszuwählenden Elemente.

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

Ausgewählte Tupelelemente.

Alternativen

tuple_first_ntuple_first_nTupleFirstNtuple_first_nTupleFirstNTupleFirstN, tuple_last_ntuple_last_nTupleLastNtuple_last_nTupleLastNTupleLastN, tuple_str_bit_selecttuple_str_bit_selectTupleStrBitSelecttuple_str_bit_selectTupleStrBitSelectTupleStrBitSelect, tuple_concattuple_concatTupleConcattuple_concatTupleConcatTupleConcat, tuple_selecttuple_selectTupleSelecttuple_selectTupleSelectTupleSelect, tuple_select_rangetuple_select_rangeTupleSelectRangetuple_select_rangeTupleSelectRangeTupleSelectRange, tuple_select_ranktuple_select_rankTupleSelectRanktuple_select_rankTupleSelectRankTupleSelectRank

Siehe auch

tuple_removetuple_removeTupleRemovetuple_removeTupleRemoveTupleRemove

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 13.0.4 Copyright © 1996-2019 MVTec Software GmbH