tuple_select_range
— Auswählen mehrerer Elemente eines Tupels.
tuple_select_range( : : Tuple, Leftindex, Rightindex : Selected)
tuple_select_range
wählt mehrere aufeinanderfolgende Elemente
eines Tupels Tuple
aus und liefert sie über den Parameter
Selected
zurück. Der Parameter Leftindex
gibt hierbei
den Index des ersten auszuwählenden Tupelelements und der Parameter
Rightindex
den Index des letzten auszuwählenden Tupelelements an.
Folgerichtig müssen beide Parameter Leftindex
und
Rightindex
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 Selected
enthält dann alle
Elemente von Tuple
, die zwischen den Positionen
Leftindex
und Rightindex
stehen (inklusive
der Elemente mit dem Index Leftindex
und Rightindex
).
Sind beide Indices gleich groß, so wird ein einzelnes Element ausgewählt.
Der Parameter Rightindex
kann darüber hinaus auch um 1 kleiner sein,
als Leftindex
. In diesem Fall wird, wenn Leftindex
oder
Rightindex
ein gültiger Index sind, ein leeres Tupel zurück
geliefert. Der Index in Rightindex
muss somit immer größer oder
gleich Leftindex
- 1 sein.
Falls Leftindex
und Rightindex
leere Tupel sind, wird ein
leerer Tupel zurückgegeben. Wenn nur einer dieser beiden Parameter oder
Tuple
ein leeres Tupel ist, wird eine Fehlermeldung angezeigt.
HDevelop unterstützt eine Inline-Operation für tuple_select_range
,
die innerhalb eines Ausdrucks in der folgenden Syntax verwendet werden
kann:
Selected := Tuple[Leftindex:Rightindex]
Tuple
(input_control) tuple(-array) →
(integer / real / string)
Eingabetupel.
Leftindex
(input_control) integer(-array) →
(integer)
Index des ersten auszuwählenden Elements.
Rightindex
(input_control) integer(-array) →
(integer)
Index des letzten auszuwählenden Elements.
Selected
(output_control) tuple(-array) →
(integer / real / string)
Ausgewählte Tupelelemente.
tuple_select
,
tuple_first_n
,
tuple_last_n
,
tuple_select_mask
,
tuple_str_bit_select
,
tuple_concat
,
tuple_select_rank
Foundation