tuple_strstrtuple_strstrTupleStrstrtuple_strstrTupleStrstrTupleStrstr (Operator)

Name

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

Signatur

tuple_strstr( : : String, ToFind : Position)

tuple_strstrtuple_strstrTupleStrstrtuple_strstrTupleStrstrTupleStrstr sucht in dem Eingabetupel StringStringStringStringStringstringVal nach den in dem Eingabetupel ToFindToFindToFindToFindToFindtoFind definierten Strings. Beide Eingabetupel müssen durchgehend aus Strings bestehen. Anderenfalls bricht tuple_strstrtuple_strstrTupleStrstrtuple_strstrTupleStrstrTupleStrstr mit einem entsprechenden Fehler ab. Besteht StringStringStringStringStringstringVal nur aus einem einzigen String, so werden in diesem alle in ToFindToFindToFindToFindToFindtoFind definierten Strings gesucht. Das Ausgabetupel besteht also in diesem Fall aus genauso vielen Elementen wie das Eingabetupel ToFindToFindToFindToFindToFindtoFind. 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 PositionPositionPositionPositionPositionposition 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 StringStringStringStringStringstringVal und ToFindToFindToFindToFindToFindtoFind gleich viele Elemente, so werden sie elementweise bearbeitet, das heißt, der erste String von ToFindToFindToFindToFindToFindtoFind wird in dem ersten String von StringStringStringStringStringstringVal, der zweite von ToFindToFindToFindToFindToFindtoFind im zweiten von StringStringStringStringStringstringVal gesucht und so weiter. Die einzelnen Elemente des Ausgabetupels enthalten dann das Resultat der elementweisen Suche. Besteht ToFindToFindToFindToFindToFindtoFind nur aus einem String, so wird dieser String in allen Strings des Eingabetupels StringStringStringStringStringstringVal gesucht. Das Ausgabetupel PositionPositionPositionPositionPositionposition besitzt dann also genauso viele Elemente wie das Eingabetupel StringStringStringStringStringstringVal. Weisen die beiden Eingabetupel StringStringStringStringStringstringVal und ToFindToFindToFindToFindToFindtoFind eine unterschiedliche Anzahl an Elementen auf, die von 1 verschieden ist, so bricht tuple_strstrtuple_strstrTupleStrstrtuple_strstrTupleStrstrTupleStrstr 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_strstrTupleStrstrtuple_strstrTupleStrstrTupleStrstr, die innerhalb eines Ausdrucks in der folgenden Syntax verwendet werden kann:

Position := strstr(String, ToFind)