tuple_find — Suchen eines Tupels in einem anderem Tupel und Rückgabe der Indizes.
tuple_find sucht im Eingabetupel Tuple in
aufsteigender Reihenfolge das zweite Eingabetupel ToFind
und liefert als Resultat die Indizes der gefundenen Subtupel
(bezogen auf das Eingabetupel Tuple) in dem Ergebnistupel
Indices zurück.
Besteht Tuple zum Beispiel aus
den Werten [3,4,5,6,1,2,3,4,0] und enthält ToFind die
beiden Werte [3,4], so beinhaltet das Ausgabetupel
Indices die Ergebniswerte [0,6]. Falls im ersten Eingabetupel
Tuple das zweite Eingabetupel ToFind nicht enthalten
ist, so wird -1 im Ergebnistupel Indices
zurückgegeben. Die Eingabetupel dürfen Strings und Zahlen auch
gemischt enthalten.
Falls eines oder beide der Eingabetupel leer sind, gibt der Operator ein leeres Tupel zurück.
HDevelop unterstützt eine Inline-Operation für tuple_find,
die innerhalb eines Ausdrucks in der folgenden Syntax verwendet werden
kann:
Indices := find(Tuple, ToFind)
Tuple (input_control) tuple(-array) → (integer / real / string)
Eingabetupel mit zu untersuchenden Strings.
ToFind (input_control) tuple(-array) → (integer / real / string)
Eingabetupel mit zu suchenden Werten.
Indices (output_control) integer(-array) → (integer)
Indizes der gefundenen Subtupel in dem zu untersuchenden Tupel.
tuple_find_first,
tuple_find_last,
tuple_sort,
tuple_inverse,
tuple_equal_elem
Foundation