CKTIS / Java
String.indexOf — trovare una sottostringa
String.indexOf restituisce l’indice della prima corrispondenza della sottostringa oppure -1. Il parametro fromIndex permette di iniziare la ricerca da una posizione specificata.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
int position = text.indexOf(str);
int positionFromIndex = text.indexOf(str, fromIndex);String.indexOf(str) trova la prima corrispondenza della sottostringa; String.indexOf(str, fromIndex) cerca a partire da fromIndex, inclusa. Il risultato è un indice a base zero nell’intera stringa oppure -1. Verifica position >= 0, non position > 0: la posizione 0 è una corrispondenza valida.
La ricerca è letterale, distingue tra maiuscole e minuscole e non interpreta le espressioni regolari. Gli indici contano unità di codice UTF-16 (char), che non corrispondono necessariamente a caratteri Unicode completi. Un fromIndex negativo equivale a 0; se str non è vuota, un indice oltre la lunghezza della stringa restituisce -1. Un indice fuori intervallo, da solo, non causa un’eccezione.
Se str è vuota, il risultato è Math.min(Math.max(fromIndex, 0), text.length()). Un argomento null per str causa una NullPointerException. Per trovare la corrispondenza successiva, eventualmente sovrapposta, di una sottostringa non vuota, dopo una corrispondenza riuscita inizia da position + 1.
Esempi
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));
}
}Risultato
1 3 -1 6
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.