WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen