tuple_findtuple_findTupleFindTupleFindtuple_find (Operator)

Name

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

Signature

tuple_find( : : Tuple, ToFind : Indices)

Herror tuple_find(const Hlong Tuple, const Hlong ToFind, Hlong* Indices)

Herror T_tuple_find(const Htuple Tuple, const Htuple ToFind, Htuple* Indices)

void TupleFind(const HTuple& Tuple, const HTuple& ToFind, HTuple* Indices)

HTuple HTuple::TupleFind(const HTuple& ToFind) const

static void HOperatorSet.TupleFind(HTuple tuple, HTuple toFind, out HTuple indices)

HTuple HTuple.TupleFind(HTuple toFind)

def tuple_find(tuple: MaybeSequence[Union[float, int, str]], to_find: MaybeSequence[Union[float, int, str]]) -> Sequence[int]

def tuple_find_s(tuple: MaybeSequence[Union[float, int, str]], to_find: MaybeSequence[Union[float, int, str]]) -> int

Description

tuple_findtuple_findTupleFindTupleFindTupleFindtuple_find searches TupleTupleTupleTupletupletuple sequentially for all occurrences of the values of the second tuple ToFindToFindToFindToFindtoFindto_find and returns the indices in IndicesIndicesIndicesIndicesindicesindices (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 tuple IndicesIndicesIndicesIndicesindicesindices will contain the values [0,6]. If the first tuple does not contain the second tuple as a subtuple, tuple_findtuple_findTupleFindTupleFindTupleFindtuple_find returns -1 in IndicesIndicesIndicesIndicesindicesindices. 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_findTupleFindTupleFindTupleFindtuple_find, which can be used in an expression in the following syntax:

Indices := find(Tuple, ToFind)

Execution Information

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 to examine.

ToFindToFindToFindToFindtoFindto_find (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 with values to find.

IndicesIndicesIndicesIndicesindicesindices (output_control)  integer(-array) HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Indices of the occurrences of the values to find in the tuple to examine.

Alternatives

tuple_find_firsttuple_find_firstTupleFindFirstTupleFindFirstTupleFindFirsttuple_find_first, tuple_find_lasttuple_find_lastTupleFindLastTupleFindLastTupleFindLasttuple_find_last, tuple_sorttuple_sortTupleSortTupleSortTupleSorttuple_sort, tuple_inversetuple_inverseTupleInverseTupleInverseTupleInversetuple_inverse, tuple_equal_elemtuple_equal_elemTupleEqualElemTupleEqualElemTupleEqualElemtuple_equal_elem

Module

Foundation