Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti