Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti