CKTIS / Java
String.indexOf — eine Teilzeichenkette finden
String.indexOf gibt den Index des ersten Treffers einer Teilzeichenkette oder -1 zurück. Mit dem Parameter fromIndex lässt sich die Suche an einer angegebenen Position beginnen.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
int position = text.indexOf(str);
int positionFromIndex = text.indexOf(str, fromIndex);String.indexOf(str) findet den ersten Treffer der Teilzeichenkette; String.indexOf(str, fromIndex) sucht ab fromIndex einschließlich. Das Ergebnis ist ein nullbasierter Index im gesamten String oder -1. Prüfe position >= 0, nicht position > 0: Position 0 ist ein gültiger Treffer.
Die Suche ist wörtlich, unterscheidet Groß- und Kleinschreibung und interpretiert keine regulären Ausdrücke. Indizes zählen UTF-16-Codeeinheiten (char), nicht unbedingt vollständige Unicode-Zeichen. Ein negatives fromIndex verhält sich wie 0; bei nicht leerem str ergibt ein Index jenseits der Stringlänge -1. Ein Index außerhalb des gültigen Bereichs verursacht für sich allein keine Ausnahme.
Für ein leeres str ergibt sich Math.min(Math.max(fromIndex, 0), text.length()). Ein null-Argument für str verursacht eine NullPointerException. Um den nächsten, möglicherweise überlappenden Treffer einer nicht leeren Teilzeichenkette zu finden, beginne nach einem erfolgreichen Treffer bei position + 1.
Beispiele
public class Main {
public static void main(String[] args) {
String text = "banana";
int first = text.indexOf("ana");
int next = text.indexOf("ana", first + 1);
System.out.println(first);
System.out.println(next);
System.out.println(text.indexOf("ANA"));
System.out.println(text.indexOf("", 99));
}
}Ergebnis
1 3 -1 6
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.