Prüfen Sie, ob Text eine Teilzeichenfolge enthält

Es liefert einen booleschen Wert und die nullbasierte Position des ersten Treffers oder -1, wenn kein Treffer vorliegt. Sie können Groß- und Kleinschreibung exakt berücksichtigen oder ignorieren. Das Ergebnis ist deterministisch, leicht zu testen und überall dort nützlich, wo ein Ablauf eine schnelle Suchbedingung ohne reguläre Ausdrücke oder unscharfen Abgleich benötigt.

Prüfen Sie eine Teilzeichenfolge mit eindeutigem Ergebnis

Geben Sie den vollständigen Wert unter text und die gesuchte Folge unter substring an. Die Antwort enthält contains; dieser Wert ist true, wenn ein Treffer existiert. Außerdem gibt position an, wo der erste Treffer beginnt. Positionen werden ab null gezählt, sodass eine direkt am Anfang gefundene Teilzeichenfolge die Position 0 hat. Fehlt sie, lauten die Ergebnisse false und -1. Dadurch bleibt ein fehlender Treffer klar von einem Treffer am Anfang unterscheidbar. Dieses Wertepaar lässt sich sowohl von Menschen gut lesen als auch von Software als Bedingung verwenden. Der Vorgang sucht nach einer wörtlichen, zusammenhängenden Teilzeichenfolge. Leerzeichen, Satzzeichen und wiederholte Zeichen gelten als gewöhnlicher Text und nicht als Muster; Zeichen für reguläre Ausdrücke müssen deshalb nicht maskiert werden. Kommt dieselbe Teilzeichenfolge mehrfach vor, wird nur die erste Position gemeldet. Dies eignet sich besonders für Validierungen, bei denen ein erwarteter Marker bestätigt und der mögliche Beginn einer weiteren Verarbeitung ermittelt werden soll. Eine leere Teilzeichenfolge wird abgelehnt, da technisch jede Zeichenfolge sie enthält und das Ergebnis irreführend wäre.

Legen Sie die Beachtung der Groß- und Kleinschreibung fest

Die Option case_sensitive ist standardmäßig true. In diesem Modus müssen Groß- und Kleinbuchstaben genau übereinstimmen: Die Suche nach „Ready“ findet „ready“ nicht. Ein exakter Abgleich ist für Kennungen, Protokollmarker, Produktcodes und alle Inhalte sinnvoll, bei denen die Schreibweise eine Bedeutung besitzt. Stellen Sie die Option auf false, wenn Sie eine praktische Textprüfung wünschen, die solche Varianten gleichbehandelt. Das ist etwa bei einem Statuswort in frei eingegebenen Notizen oder bei einer Phrase in einer Überschrift hilfreich. Im Modus ohne Beachtung der Schreibweise werden Quelltext und Suchfolge vor der Ermittlung des ersten Treffers einheitlich normalisiert; die gemeldete Position bezieht sich dennoch auf den Originaltext. Die Fähigkeit entfernt weder äußere Leerzeichen noch verändert sie Satzzeichen, sodass beide weiterhin relevant sind. Akzente werden nicht vereinheitlicht; auch Wortstammermittlung, Transliteration, unscharfer Vergleich und Ganzworterkennung finden nicht statt. So kann „cat“ den Anfang von „catalog“ treffen. Der eng gefasste Funktionsumfang hält jedes Ergebnis reproduzierbar und verhindert unbemerkte sprachliche Annahmen.

Verwenden Sie die Position sicher in Validierungsabläufen

Ein typischer Ablauf sendet einen zu prüfenden Wert, wertet contains aus und verzweigt, ohne das numerische Feld interpretieren zu müssen. Liegt ein Treffer vor, kann position für Diagnosen, Vorschauen oder einen späteren Verarbeitungsschritt genutzt werden. Eine Importprüfung kann zum Beispiel bestätigen, dass eine Kopfzeile ein vorgeschriebenes Token enthält, und dessen Anfang festhalten. Ein Test kann kontrollieren, ob erzeugter Text eine genehmigte Formulierung enthält. Ein Supportwerkzeug kann einen bekannten Marker in einer eingefügten Protokollzeile erkennen. Behandeln Sie die zurückgegebene Position stets als JavaScript-Zeichenfolgenindex in UTF-16-Codeeinheiten. Bei gewöhnlichem lateinischem Text entspricht dies der vertrauten Zeichenzählung; einige Emoji und seltenere Unicode-Zeichen belegen jedoch zwei Einheiten. Der native Plattformindex wird bewusst ausgegeben, damit Browser und API identisch arbeiten und Sie ihn direkt mit JavaScript-Methoden zum Ausschneiden verwenden können. Es handelt sich um eine wörtliche Suche, nicht um eine Sicherheitsbereinigung oder Inhaltsklassifizierung. Prüfen Sie sensible Formate gesondert und verwenden Sie einen spezialisierten Parser, wenn Grenzen, Maskierungsregeln oder mehrere Treffer entscheidend sind.