Funktionreferenz


StringInStr

Beschreibung anzeigen in

Prüft, ob ein String einen angegebenen Unterstring enthält.

StringInStr ( "string", "substring" [, casesense = 0 [, occurrence = 1 [, start = 1 [, count]]]] )

Parameter

string Der String, der geprüft werden soll.
substring Der Unterstring, nach dem gesucht werden soll.
casesense [optional] Flag, ob der Befehl Groß-/Kleinschreibung berücksichtigen soll.
    $STR_NOCASESENSE (0) = Groß- und Kleinschreibung werden nicht berücksichtigt (Standardwert).
    $STR_CASESENSE (1) = Berücksichtigt Groß- und Kleinschreibung.
    $STR_NOCASESENSEBASIC (2) = Groß- und Kleinschreibung werden nicht berücksichtigt. Es findet ein einfacherer, schnellerer Vergleich statt.

Die Konstanten sind in StringConstants.au3 definiert
occurrence [optional] Das wievielte Auftreten des Unterstrings soll gefunden werden. Ist der Wert negativ, wird von rechts ausgehend gesucht. Der Standardwert ist 1 (erstes Auftreten von links ausgehend).
start [optional] Die Startposition für die Suche.
count [optional] Die Anzahl der zu vergleichenden Zeichen. Dies begrenzt effektiv die Suche des kompletten Strings auf einen bestimmten Bereich. Siehe Bemerkungen.

Rückgabewert

Erfolg: Die Position des Unterstrings.
Fehler: 0 wenn der Unterstring nicht gefunden wird.
@error: 1 = ungültiger "start" oder "occurance" Parameter.

Bemerkungen

Die erste Zeichenposition ist 1.

Der count Parameter darf nicht kürzer wie der zu suchenden Teilstring sein. Der count Parameter (kombiniert mit dem start Parameter) begrenzt effektiv die Suche des kompletten Strings auf einen bestimmten Bereich. Die folgenden Befehle sind gleich:
StringInStr("zu suchender String um bei", "String", 0, 1, 1, 19)
StringInStr(StringMid("zu suchender String um bei", 1, 19), "String")

Verwandte Funktionen

StringCompare, StringLeft, StringLen, StringLower, StringMid, StringRegExp, StringRight, StringSplit, StringTrimLeft, StringTrimRight, StringUpper

Beispiel

#include <MsgBoxConstants.au3>

; Ermittelt die Zeichenposition an der der String 'weiss' das erste Mal im Satz auftaucht
Local $iPosition = StringInStr("Dies ist ein Satz mit Leerzeichen.", "leer")
MsgBox($MB_SYSTEMMODAL, "", "Die Suchposition des Strings 'leer' taucht zuerst an folgender Position auf: " & $iPosition)