tuple_select_rangetuple_select_rangeTupleSelectRangeTupleSelectRange (Operator)

Name

tuple_select_rangetuple_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)

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

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

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_rangeTupleSelectRangeTupleSelectRangeTupleSelectRange wählt mehrere aufeinanderfolgende Elemente eines Tupels TupleTupleTupleTupletuple aus und liefert sie über den Parameter SelectedSelectedSelectedSelectedselected zurück. Der Parameter LeftindexLeftindexLeftindexLeftindexleftindex gibt hierbei den Index des ersten auszuwählenden Tupelelements und der Parameter RightindexRightindexRightindexRightindexrightindex den Index des letzten auszuwählenden Tupelelements an. Folgerichtig müssen beide Parameter LeftindexLeftindexLeftindexLeftindexleftindex und RightindexRightindexRightindexRightindexrightindex 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 SelectedSelectedSelectedSelectedselected enthält dann alle Elemente von TupleTupleTupleTupletuple, die zwischen den Positionen LeftindexLeftindexLeftindexLeftindexleftindex und RightindexRightindexRightindexRightindexrightindex stehen (inklusive der Elemente mit dem Index LeftindexLeftindexLeftindexLeftindexleftindex und RightindexRightindexRightindexRightindexrightindex). Sind beide Indices gleich groß, so wird ein einzelnes Element ausgewählt. Der Parameter RightindexRightindexRightindexRightindexrightindex kann darüber hinaus auch um 1 kleiner sein, als LeftindexLeftindexLeftindexLeftindexleftindex. In diesem Fall wird, wenn LeftindexLeftindexLeftindexLeftindexleftindex oder RightindexRightindexRightindexRightindexrightindex ein gültiger Index sind, ein leeres Tupel zurück geliefert. Der Index in RightindexRightindexRightindexRightindexrightindex muss somit immer größer oder gleich LeftindexLeftindexLeftindexLeftindexleftindex - 1 sein.

Sonderfall: Leere Eingabetupel

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

HDevelop Inline-Operation

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

Selected := Tuple[Leftindex:Rightindex]

Ausführungsinformationen

Parameter

TupleTupleTupleTupletuple (input_control)  tuple(-array) HTupleHTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)

Eingabetupel.

LeftindexLeftindexLeftindexLeftindexleftindex (input_control)  integer(-array) HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Index des ersten auszuwählenden Elements.

RightindexRightindexRightindexRightindexrightindex (input_control)  integer(-array) HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Index des letzten auszuwählenden Elements.

SelectedSelectedSelectedSelectedselected (output_control)  tuple(-array) HTupleHTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)

Ausgewählte Tupelelemente.

Alternativen

tuple_selecttuple_selectTupleSelectTupleSelectTupleSelect, tuple_first_ntuple_first_nTupleFirstNTupleFirstNTupleFirstN, tuple_last_ntuple_last_nTupleLastNTupleLastNTupleLastN, tuple_select_masktuple_select_maskTupleSelectMaskTupleSelectMaskTupleSelectMask, tuple_str_bit_selecttuple_str_bit_selectTupleStrBitSelectTupleStrBitSelectTupleStrBitSelect, tuple_concattuple_concatTupleConcatTupleConcatTupleConcat, tuple_select_ranktuple_select_rankTupleSelectRankTupleSelectRankTupleSelectRank

Siehe auch

tuple_removetuple_removeTupleRemoveTupleRemoveTupleRemove

Modul

Foundation