CKTIS / Java
ArrayIndexOutOfBoundsException — indice dell’array fuori dai limiti
ArrayIndexOutOfBoundsException segnala l’accesso a un array con un indice negativo o maggiore o uguale alla lunghezza dell’array. Un indice valido soddisfa 0 <= index && index < array.length.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
array[index]
new ArrayIndexOutOfBoundsException()
new ArrayIndexOutOfBoundsException(index)
new ArrayIndexOutOfBoundsException(s)ArrayIndexOutOfBoundsException indica un tentativo di accedere a un elemento dell’array al di fuori dei suoi limiti. In un array non vuoto, gli indici vanno da 0 a array.length - 1; un array vuoto non ha indici validi. Java controlla i limiti durante l’esecuzione. La lettura tramite un riferimento null genera invece NullPointerException.
La classe estende IndexOutOfBoundsException e, indirettamente, RuntimeException, quindi è un’eccezione non controllata: non è necessario catturarla né dichiararla in throws. IndexOutOfBoundsException è un tipo di errore di indicizzazione più generale, non limitato agli array.
I costruttori sono ArrayIndexOutOfBoundsException(), ArrayIndexOutOfBoundsException(int index) e ArrayIndexOutOfBoundsException(String s): rispettivamente senza messaggio, con l’indice non valido e con un messaggio fornito. Il formato del messaggio per la variante int non è specificato; non basare i test su di esso.
Per evitare l’errore, controlla 0 <= index && index < array.length; in un ciclo usa index < array.length, non index <= array.length. L’esempio cattura intenzionalmente l’eccezione per mostrare un errore di un’unità: values.length è già fuori dall’array. Nel codice ordinario, correggi il calcolo dell’indice invece di nascondere il problema catturando l’eccezione.
Esempi
public class Main {
public static void main(String[] args) {
int[] values = {10, 20, 30};
System.out.println(values[values.length - 1]);
try {
System.out.println(values[values.length]);
} catch (ArrayIndexOutOfBoundsException ex) {
System.out.println("ArrayIndexOutOfBoundsException");
}
}
}Risultato
30 ArrayIndexOutOfBoundsException
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.