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