tuple_last_ntuple_last_nTupleLastNTupleLastNtuple_last_n (Operator)
Name
tuple_last_ntuple_last_nTupleLastNTupleLastNtuple_last_n
— Select all elements from index “n” to the end of a tuple.
Signature
def tuple_last_n(tuple: MaybeSequence[Union[float, int, str]], index: int) -> Sequence[Union[float, int, str]]
def tuple_last_n_s(tuple: MaybeSequence[Union[float, int, str]], index: int) -> Union[float, int, str]
Description
Starting with the “n-th” element of the tuple TupleTupleTupleTupletupletuple
,
tuple_last_ntuple_last_nTupleLastNTupleLastNTupleLastNtuple_last_n
selects every element of TupleTupleTupleTupletupletuple
and returns
it with SelectedSelectedSelectedSelectedselectedselected
. Thus, SelectedSelectedSelectedSelectedselectedselected
contains all
elements of TupleTupleTupleTupletupletuple
from index “n” up to the last element
of TupleTupleTupleTupletupletuple
(including the element at position “n”). The index
“n” is determined by the input parameter IndexIndexIndexIndexindexindex
. Thus,
IndexIndexIndexIndexindexindex
must contain a single integer value (if IndexIndexIndexIndexindexindex
consists of a floating point number, this must represent
an integer value without fraction). Indices of tuple elements start at 0,
that means, the first tuple element has got the index 0.
Exception: Empty input tuple
If TupleTupleTupleTupletupletuple
is empty, an exception is raised.
HDevelop In-line Operation
HDevelop provides an in-line operation for tuple_last_ntuple_last_nTupleLastNTupleLastNTupleLastNtuple_last_n
,
which can be used in an expression in the following syntax:
Selected := lastn(Tuple, Index)
Execution Information
- Multithreading type: independent (runs in parallel even with exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
TupleTupleTupleTupletupletuple
(input_control) tuple(-array) →
HTupleMaybeSequence[Union[float, int, str]]HTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Input tuple.
IndexIndexIndexIndexindexindex
(input_control) integer →
HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Index of the first element to select.
SelectedSelectedSelectedSelectedselectedselected
(output_control) tuple(-array) →
HTupleSequence[Union[float, int, str]]HTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Selected tuple elements.
Alternatives
tuple_first_ntuple_first_nTupleFirstNTupleFirstNTupleFirstNtuple_first_n
,
tuple_selecttuple_selectTupleSelectTupleSelectTupleSelecttuple_select
,
tuple_str_bit_selecttuple_str_bit_selectTupleStrBitSelectTupleStrBitSelectTupleStrBitSelecttuple_str_bit_select
,
tuple_concattuple_concatTupleConcatTupleConcatTupleConcattuple_concat
,
tuple_select_masktuple_select_maskTupleSelectMaskTupleSelectMaskTupleSelectMasktuple_select_mask
See also
tuple_removetuple_removeTupleRemoveTupleRemoveTupleRemovetuple_remove
Module
Foundation