tuple_find_firsttuple_find_firstTupleFindFirstTupleFindFirsttuple_find_first (Operator)
Name
tuple_find_firsttuple_find_firstTupleFindFirstTupleFindFirsttuple_find_first
— Return the index of the first occurrence of a tuple within another tuple.
Signature
def tuple_find_first(tuple: MaybeSequence[Union[int, float, str]], to_find: MaybeSequence[Union[int, float, str]]) -> int
Description
tuple_find_firsttuple_find_firstTupleFindFirstTupleFindFirsttuple_find_first
searches forward through TupleTupleTupletupletuple
for the first occurrence of the values of the second tuple
ToFindToFindToFindtoFindto_find
and returns the IndexIndexIndexindexindex
(in relation to the
first input tuple TupleTupleTupletupletuple
). For example, if TupleTupleTupletupletuple
contains the values [3,4,5,6,1,2,3,4,0] and ToFindToFindToFindtoFindto_find
contains
the values [3,4], the output IndexIndexIndexindexindex
is 0. If the first tuple
does not contain the second tuple as a subtuple,
tuple_find_firsttuple_find_firstTupleFindFirstTupleFindFirsttuple_find_first
returns -1 in IndexIndexIndexindexindex
. It is allowed
to mix strings and numbers in the input tuples.
Exception: Empty input tuples
If either or both of the input tuples are empty, the operator returns an
empty tuple.
HDevelop In-line Operation
HDevelop provides an in-line operation for tuple_find_firsttuple_find_firstTupleFindFirstTupleFindFirsttuple_find_first
,
which can be used in an expression in the following syntax:
Index := find_first(Tuple, ToFind)
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
TupleTupleTupletupletuple
(input_control) tuple(-array) →
HTupleMaybeSequence[Union[int, float, str]]HTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Input tuple to examine.
ToFindToFindToFindtoFindto_find
(input_control) tuple(-array) →
HTupleMaybeSequence[Union[int, float, str]]HTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Input tuple with values to find.
IndexIndexIndexindexindex
(output_control) integer →
HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Index of the first occurrence of the values to find.
Alternatives
tuple_findtuple_findTupleFindTupleFindtuple_find
,
tuple_find_lasttuple_find_lastTupleFindLastTupleFindLasttuple_find_last
,
tuple_sorttuple_sortTupleSortTupleSorttuple_sort
,
tuple_equal_elemtuple_equal_elemTupleEqualElemTupleEqualElemtuple_equal_elem
Module
Foundation