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

tuple_selecttuple_selectTupleSelecttuple_selectTupleSelectTupleSelect (Operator)

Name

tuple_selecttuple_selectTupleSelecttuple_selectTupleSelectTupleSelect — Auswählen einzelner Elemente aus einem Tupel.

Signatur

tuple_select( : : Tuple, Index : Selected)

Herror tuple_select(const Hlong Tuple, const Hlong Index, Hlong* Selected)

Herror T_tuple_select(const Htuple Tuple, const Htuple Index, Htuple* Selected)

Herror tuple_select(const HTuple& Tuple, const HTuple& Index, Hlong* Selected)

Herror tuple_select(const HTuple& Tuple, const HTuple& Index, HTuple* Selected)

void TupleSelect(const HTuple& Tuple, const HTuple& Index, HTuple* Selected)

HTuple HTuple::TupleSelect(const HTuple& Index) const

void HOperatorSetX.TupleSelect(
[in] VARIANT Tuple, [in] VARIANT Index, [out] VARIANT* Selected)

VARIANT HTupleX.TupleSelect(
[in] VARIANT Tuple, [in] VARIANT Index)

static void HOperatorSet.TupleSelect(HTuple tuple, HTuple index, out HTuple selected)

HTuple HTuple.TupleSelect(HTuple index)

Beschreibung

tuple_selecttuple_selectTupleSelecttuple_selectTupleSelectTupleSelect wählt einzelne Elemente aus einem Tupel TupleTupleTupleTupleTupletuple aus und liefert sie über den Parameter SelectedSelectedSelectedSelectedSelectedselected zurück. Der Parameter IndexIndexIndexIndexIndexindex gibt hierbei einen oder mehrere Indizes an, über die festgelegt wird, welche Elemente ausgewählt werden. Folgerichtig 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.

Sonderfall: Leeres Eingabetupel

Falls TupleTupleTupleTupleTupletuple leer ist, wird eine Fehlermeldung angezeigt.

HDevelop Inline-Operation

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

Selected := Tuple[Index]

Selected := subset(Tuple, Index)

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 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ähltes Tupelelement.

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_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