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

Description

tuple_find_firsttuple_find_firstTupleFindFirstTupleFindFirstTupleFindFirsttuple_find_first searches forward through TupleTupleTupleTupletupletuple for the first occurrence of the values of the second tuple ToFindToFindToFindToFindtoFindto_find and returns the IndexIndexIndexIndexindexindex (in relation to the first input tuple TupleTupleTupleTupletupletuple). For example, if TupleTupleTupleTupletupletuple contains the values [3,4,5,6,1,2,3,4,0] and ToFindToFindToFindToFindtoFindto_find contains the values [3,4], the output IndexIndexIndexIndexindexindex is 0. If the first tuple does not contain the second tuple as a subtuple, tuple_find_firsttuple_find_firstTupleFindFirstTupleFindFirstTupleFindFirsttuple_find_first returns -1 in IndexIndexIndexIndexindexindex. 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_firstTupleFindFirstTupleFindFirstTupleFindFirsttuple_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

Alternatives

tuple_findtuple_findTupleFindTupleFindTupleFindtuple_find, tuple_find_lasttuple_find_lastTupleFindLastTupleFindLastTupleFindLasttuple_find_last, tuple_sorttuple_sortTupleSortTupleSortTupleSorttuple_sort, tuple_equal_elemtuple_equal_elemTupleEqualElemTupleEqualElemTupleEqualElemtuple_equal_elem

Module

Foundation