tuple_strstrtuple_strstrTupleStrstrTupleStrstr (Operator)

Name

tuple_strstrtuple_strstrTupleStrstrTupleStrstr — Vorwärtssuchen nach einem Teilstring in einem Tupel von Strings.

Signatur

tuple_strstr( : : String, ToFind : Position)

tuple_strstrtuple_strstrTupleStrstrTupleStrstrTupleStrstr sucht in dem Eingabetupel StringStringStringStringstringVal nach den in dem Eingabetupel ToFindToFindToFindToFindtoFind definierten Strings. Beide Eingabetupel müssen durchgehend aus Strings bestehen. Anderenfalls bricht tuple_strstrtuple_strstrTupleStrstrTupleStrstrTupleStrstr mit einem entsprechenden Fehler ab. Besteht StringStringStringStringstringVal nur aus einem einzigen String, so werden in diesem alle in ToFindToFindToFindToFindtoFind definierten Strings gesucht. Das Ausgabetupel besteht also in diesem Fall aus genauso vielen Elementen wie das Eingabetupel ToFindToFindToFindToFindtoFind. Ist die Suche nach einem String erfolgreich, so wird die Position, an der der gesuchte String innerhalb des untersuchten Strings das erste Mal gefunden wurde, in dem Ausgabetupel PositionPositionPositionPositionposition zurückgegeben (die Position wird beginnend mit 0 gezählt). Wurde ein String nicht gefunden, so wird für dessen Position der Wert -1 zurückgegeben. Enthalten beide Eingabetupel StringStringStringStringstringVal und ToFindToFindToFindToFindtoFind gleich viele Elemente, so werden sie elementweise bearbeitet, das heißt, der erste String von ToFindToFindToFindToFindtoFind wird in dem ersten String von StringStringStringStringstringVal, der zweite von ToFindToFindToFindToFindtoFind im zweiten von StringStringStringStringstringVal gesucht und so weiter. Die einzelnen Elemente des Ausgabetupels enthalten dann das Resultat der elementweisen Suche. Besteht ToFindToFindToFindToFindtoFind nur aus einem String, so wird dieser String in allen Strings des Eingabetupels StringStringStringStringstringVal gesucht. Das Ausgabetupel PositionPositionPositionPositionposition besitzt dann also genauso viele Elemente wie das Eingabetupel StringStringStringStringstringVal. Weisen die beiden Eingabetupel StringStringStringStringstringVal und ToFindToFindToFindToFindtoFind eine unterschiedliche Anzahl an Elementen auf, die von 1 verschieden ist, so bricht tuple_strstrtuple_strstrTupleStrstrTupleStrstrTupleStrstr mit einem entsprechenden Fehler ab.

Für allgemeine Informationen zu String-Operationen siehe auch Tupel / String-Operationen.

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_strstrtuple_strstrTupleStrstrTupleStrstrTupleStrstr, die innerhalb eines Ausdrucks in der folgenden Syntax verwendet werden kann:

Position := strstr(String, ToFind)