CKTIS / Java
String.indexOf — wyszukiwanie podciągu
String.indexOf zwraca indeks pierwszego wystąpienia podciągu albo -1. Parametr fromIndex pozwala rozpocząć wyszukiwanie od wskazanej pozycji.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
int position = text.indexOf(str);
int positionFromIndex = text.indexOf(str, fromIndex);String.indexOf(str) wyszukuje pierwszy podciąg, a String.indexOf(str, fromIndex) rozpoczyna wyszukiwanie od fromIndex włącznie. Wynik to indeks w całym napisie, liczony od zera, albo -1. Sprawdzaj position >= 0, nie position > 0: pozycja 0 oznacza poprawne dopasowanie.
Wyszukiwanie jest dosłowne, rozróżnia wielkość liter i nie interpretuje wyrażeń regularnych. Indeksy oznaczają jednostki UTF-16 (char), niekoniecznie całe znaki Unicode. Ujemny fromIndex działa jak 0; dla niepustego str indeks przekraczający długość napisu daje -1. Sam indeks spoza zakresu nie powoduje wyjątku.
Pusty str daje Math.min(Math.max(fromIndex, 0), text.length()). Argument str równy null powoduje NullPointerException. Aby znaleźć kolejne, również nakładające się dopasowanie niepustego podciągu, po sukcesie rozpocznij od position + 1.
Przykłady
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));
}
}Wynik
1 3 -1 6
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.