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.