Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

String.indexOf — hledání podřetězce

String.indexOf vrací index prvního výskytu podřetězce, nebo -1. Parametr fromIndex umožňuje začít hledat na zadané pozici.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

int position = text.indexOf(str);
int positionFromIndex = text.indexOf(str, fromIndex);

String.indexOf(str) najde první výskyt podřetězce; String.indexOf(str, fromIndex) hledá od pozice fromIndex včetně. Výsledkem je index počítaný od nuly v celém řetězci, nebo -1. Kontrolujte position >= 0, ne position > 0: pozice 0 je platný výskyt.

Hledání je doslovné, rozlišuje velká a malá písmena a neinterpretuje regulární výrazy. Indexy počítají jednotky kódu UTF-16 (char), které nemusí odpovídat celým znakům Unicode. Záporný fromIndex se chová jako 0; u neprázdného str vrátí index větší než délka řetězce hodnotu -1. Samotný index mimo rozsah výjimku nezpůsobí.

Pro prázdné str je výsledkem Math.min(Math.max(fromIndex, 0), text.length()). Argument null pro str způsobí NullPointerException. Chcete-li najít další, případně překrývající se výskyt neprázdného podřetězce, začněte po úspěšném nálezu na pozici position + 1.

Příklady

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));
    }
}

Výsledek

1
3
-1
6

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje