KlassenKlassenKlassenKlassen | | | | Operatoren

tuple_select_rangetuple_select_rangeTupleSelectRangetuple_select_rangeTupleSelectRangeTupleSelectRange (Operator)

Name

tuple_select_rangetuple_select_rangeTupleSelectRangetuple_select_rangeTupleSelectRangeTupleSelectRange — Auswählen mehrerer Elemente eines Tupels.

Signatur

tuple_select_range( : : Tuple, Leftindex, Rightindex : Selected)

Herror tuple_select_range(const Hlong Tuple, const Hlong Leftindex, const Hlong Rightindex, Hlong* Selected)

Herror T_tuple_select_range(const Htuple Tuple, const Htuple Leftindex, const Htuple Rightindex, Htuple* Selected)

Herror tuple_select_range(const HTuple& Tuple, const HTuple& Leftindex, const HTuple& Rightindex, Hlong* Selected)

Herror tuple_select_range(const HTuple& Tuple, const HTuple& Leftindex, const HTuple& Rightindex, HTuple* Selected)

void TupleSelectRange(const HTuple& Tuple, const HTuple& Leftindex, const HTuple& Rightindex, HTuple* Selected)

HTuple HTuple::TupleSelectRange(const HTuple& Leftindex, const HTuple& Rightindex) const

void HOperatorSetX.TupleSelectRange(
[in] VARIANT Tuple, [in] VARIANT Leftindex, [in] VARIANT Rightindex, [out] VARIANT* Selected)

VARIANT HTupleX.TupleSelectRange(
[in] VARIANT Tuple, [in] VARIANT Leftindex, [in] VARIANT Rightindex)

static void HOperatorSet.TupleSelectRange(HTuple tuple, HTuple leftindex, HTuple rightindex, out HTuple selected)

HTuple HTuple.TupleSelectRange(HTuple leftindex, HTuple rightindex)

Beschreibung

tuple_select_rangetuple_select_rangeTupleSelectRangetuple_select_rangeTupleSelectRangeTupleSelectRange wählt mehrere aufeinanderfolgende Elemente eines Tupels TupleTupleTupleTupleTupletuple aus und liefert sie über den Parameter SelectedSelectedSelectedSelectedSelectedselected zurück. Der Parameter LeftindexLeftindexLeftindexLeftindexLeftindexleftindex gibt hierbei den Index des ersten auszuwählenden Tupelelements und der Parameter RightindexRightindexRightindexRightindexRightindexrightindex den Index des letzten auszuwählenden Tupelelements an. Folgerichtig müssen beide Parameter LeftindexLeftindexLeftindexLeftindexLeftindexleftindex und RightindexRightindexRightindexRightindexRightindexrightindex eine ganze Zahl beinhalten (falls sie eine Gleitkommazahl enthalten, so muss diese eine ganze Zahl repräsentieren; alle Nachkommastellen der Zahl müssen also 0 sein). Der Index eines Tupelelements wird beginnend mit 0 gezählt, das heißt, das erste Tupelelement wird über den Index 0 ausgewählt. Das Ergebnistupel SelectedSelectedSelectedSelectedSelectedselected enthält dann alle Elemente von TupleTupleTupleTupleTupletuple, die zwischen den Positionen LeftindexLeftindexLeftindexLeftindexLeftindexleftindex und RightindexRightindexRightindexRightindexRightindexrightindex stehen (inklusive der Elemente mit dem Index LeftindexLeftindexLeftindexLeftindexLeftindexleftindex und RightindexRightindexRightindexRightindexRightindexrightindex). Sind beide Indices gleich groß, so wird ein einzelnes Element ausgewählt. Der Parameter RightindexRightindexRightindexRightindexRightindexrightindex kann darüber hinaus auch um 1 kleiner sein, als LeftindexLeftindexLeftindexLeftindexLeftindexleftindex. In diesem Fall wird, wenn LeftindexLeftindexLeftindexLeftindexLeftindexleftindex oder RightindexRightindexRightindexRightindexRightindexrightindex ein gültiger Index sind, ein leeres Tupel zurück geliefert. Der Index in RightindexRightindexRightindexRightindexRightindexrightindex muss somit immer größer oder gleich LeftindexLeftindexLeftindexLeftindexLeftindexleftindex - 1 sein.

Sonderfall: Leere Eingabetupel

Falls LeftindexLeftindexLeftindexLeftindexLeftindexleftindex und RightindexRightindexRightindexRightindexRightindexrightindex leere Tupel sind, wird ein leerer Tupel zurückgegeben. Wenn nur einer dieser beiden Parameter oder TupleTupleTupleTupleTupletuple ein leeres Tupel ist, wird eine Fehlermeldung angezeigt.

HDevelop Inline-Operation

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

Selected := Tuple[Leftindex:Rightindex]

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.

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

Index des ersten auszuwählenden Elements.

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

Index des letzten auszuwählenden Elements.

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_selecttuple_selectTupleSelecttuple_selectTupleSelectTupleSelect, tuple_first_ntuple_first_nTupleFirstNtuple_first_nTupleFirstNTupleFirstN, tuple_last_ntuple_last_nTupleLastNtuple_last_nTupleLastNTupleLastN, tuple_select_masktuple_select_maskTupleSelectMasktuple_select_maskTupleSelectMaskTupleSelectMask, tuple_str_bit_selecttuple_str_bit_selectTupleStrBitSelecttuple_str_bit_selectTupleStrBitSelectTupleStrBitSelect, tuple_concattuple_concatTupleConcattuple_concatTupleConcatTupleConcat, tuple_select_ranktuple_select_rankTupleSelectRanktuple_select_rankTupleSelectRankTupleSelectRank

Siehe auch

tuple_removetuple_removeTupleRemovetuple_removeTupleRemoveTupleRemove

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren