tuple_find_firsttuple_find_firstTupleFindFirstTupleFindFirst (Operator)
Name
tuple_find_firsttuple_find_firstTupleFindFirstTupleFindFirst
— Suchen nach dem Index des ersten gefundenen Subtupel in einem Tupel.
Signatur
Beschreibung
tuple_find_firsttuple_find_firstTupleFindFirstTupleFindFirstTupleFindFirst
durchsucht TupleTupleTupleTupletuple
in aufsteigender
Reihenfolge nach dem zweiten Tupel ToFindToFindToFindToFindtoFind
und gibt den
entsprechenden IndexIndexIndexIndexindex
bezüglich TupleTupleTupleTupletuple
zurück. Beispielsweise liefert tuple_find_firsttuple_find_firstTupleFindFirstTupleFindFirstTupleFindFirst
für
TupleTupleTupleTupletuple
mit den Werten [3,4,5,6,1,2,3,4,0] und
ToFindToFindToFindToFindtoFind
mit den Werten [3,4] für IndexIndexIndexIndexindex
den Wert
0. Enthält TupleTupleTupleTupletuple
ToFindToFindToFindToFindtoFind
nicht, so liefert der
Operator für IndexIndexIndexIndexindex
den Wert -1. Der Operator akzeptiert
gemischte Eingabe-Tupel aus Zahlen und Strings.
Sonderfall: Leere Eingabetupel
Falls eines oder beide der Eingabetupel leer sind, gibt der Operator ein
leeres Tupel zurück.
HDevelop Inline-Operation
HDevelop unterstützt eine Inline-Operation für tuple_find_firsttuple_find_firstTupleFindFirstTupleFindFirstTupleFindFirst
,
die innerhalb eines Ausdrucks in der folgenden Syntax verwendet werden
kann:
Index := find_first(Tuple, ToFind)
Ausführungsinformationen
- Multithreading-Typ: independent (läuft parallel auch zu exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
TupleTupleTupleTupletuple
(input_control) tuple(-array) →
HTupleHTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Eingabetupel mit zu untersuchenden Strings.
ToFindToFindToFindToFindtoFind
(input_control) tuple(-array) →
HTupleHTupleHtuple (integer / real / string) (int / long / double / string) (Hlong / double / HString) (Hlong / double / char*)
Eingabetupel mit zu suchenden Werten.
IndexIndexIndexIndexindex
(output_control) integer →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Index des ersten gefundenen Subtupel in dem zu
untersuchenden Tupel.
Alternativen
tuple_findtuple_findTupleFindTupleFindTupleFind
,
tuple_find_lasttuple_find_lastTupleFindLastTupleFindLastTupleFindLast
,
tuple_sorttuple_sortTupleSortTupleSortTupleSort
,
tuple_equal_elemtuple_equal_elemTupleEqualElemTupleEqualElemTupleEqualElem
Modul
Foundation