tuple_findtuple_findTupleFindTupleFind (Operator)

Name

tuple_findtuple_findTupleFindTupleFind — Return the indices of all occurrences of a tuple within another tuple.

Signature

tuple_find( : : Tuple, ToFind : Indices)

tuple_findtuple_findTupleFindTupleFindTupleFind searches TupleTupleTupleTupletuple sequentially for all occurrences of the values of the second tuple ToFindToFindToFindToFindtoFind and returns the indices in IndicesIndicesIndicesIndicesindices (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 ToFindToFindToFindToFindtoFind contains the values [3,4], the output tuple IndicesIndicesIndicesIndicesindices will contain the values [0,6]. If the first tuple does not contain the second tuple as a subtuple, tuple_findtuple_findTupleFindTupleFindTupleFind returns -1 in IndicesIndicesIndicesIndicesindices. 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_findtuple_findTupleFindTupleFindTupleFind, which can be used in an expression in the following syntax:

Indices := find(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.