CKTIS / Java
IndexOutOfBoundsException — indice fuori dall’intervallo valido
IndexOutOfBoundsException segnala un indice fuori dall’intervallo consentito. Scopri il suo rapporto con RuntimeException, le sue sottoclassi specializzate e come verificare esplicitamente un indice di array.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
public IndexOutOfBoundsException()
public IndexOutOfBoundsException(String message)
public IndexOutOfBoundsException(int index)
public IndexOutOfBoundsException(long index)java.lang.IndexOutOfBoundsException segnala un indice fuori dall’intervallo consentito da un’operazione. Estende RuntimeException, quindi è un’eccezione non controllata: il compilatore non richiede di intercettarla né di dichiararla con throws.
Per accedere a un elemento di un array, un indice è valido se soddisfa 0 <= index && index < values.length. Un indice uguale alla lunghezza è già non valido; un array vuoto non ha indici validi. L’accesso diretto a un array con un indice non valido genera ArrayIndexOutOfBoundsException. Questa classe e StringIndexOutOfBoundsException estendono IndexOutOfBoundsException, quindi un blocco catch per la classe base intercetta anche queste eccezioni.
I costruttori non accettano argomenti oppure accettano un argomento di tipo String, int o long. Le versioni numeriche includono l’indice nel messaggio, ma il formato esatto non è specificato. Non basare la logica del programma sull’analisi di questi messaggi.
L’esempio controlla esplicitamente i limiti e genera l’eccezione con un messaggio personalizzato. L’intercettazione ha uno scopo dimostrativo; nel codice ordinario, correggi il calcolo dell’indice o verificalo al confine dell’API, invece di ignorare l’eccezione e continuare con presupposti non validi.
Esempi
public class Main {
static int read(int[] values, int index) {
if (index < 0 || index >= values.length) {
throw new IndexOutOfBoundsException("Invalid index: " + index);
}
return values[index];
}
public static void main(String[] args) {
int[] values = {10, 20};
System.out.println(read(values, 1));
try {
System.out.println(read(values, 2));
} catch (IndexOutOfBoundsException e) {
System.out.println(e.getMessage());
}
}
}Risultato
20 Invalid index: 2
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.