CKTIS / Java
ArrayIndexOutOfBoundsException — indeks poza zakresem tablicy
ArrayIndexOutOfBoundsException sygnalizuje dostęp do tablicy z indeksem ujemnym lub nie mniejszym niż jej długość. Poprawny indeks spełnia warunek 0 <= index && index < array.length.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
array[index]
new ArrayIndexOutOfBoundsException()
new ArrayIndexOutOfBoundsException(index)
new ArrayIndexOutOfBoundsException(s)ArrayIndexOutOfBoundsException oznacza próbę dostępu do elementu tablicy poza jej zakresem. Dla niepustej tablicy indeksy biegną od 0 do array.length - 1; pusta tablica nie ma poprawnego indeksu. Java sprawdza zakres podczas wykonania. Przy odczycie przez referencję null zgłaszany jest natomiast NullPointerException.
Klasa dziedziczy po IndexOutOfBoundsException, a pośrednio po RuntimeException, więc jest wyjątkiem niekontrolowanym: nie trzeba go przechwytywać ani deklarować w throws. IndexOutOfBoundsException jest ogólniejszym typem błędu indeksowania, nie tylko tablic.
Dostępne konstruktory to ArrayIndexOutOfBoundsException(), ArrayIndexOutOfBoundsException(int index) i ArrayIndexOutOfBoundsException(String s): odpowiednio bez komunikatu, z błędnym indeksem i z podanym komunikatem. Format komunikatu wariantu z int nie jest określony — nie opieraj na nim testów.
Aby zapobiec błędowi, sprawdzaj 0 <= index && index < array.length; w pętli używaj index < array.length, nie index <= array.length. Przykład celowo przechwytuje wyjątek, aby pokazać błąd o jeden: values.length leży już poza tablicą. W zwykłym kodzie popraw obliczanie indeksu zamiast ukrywać błąd przez przechwycenie wyjątku.
Przykłady
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");
}
}
}Wynik
30 ArrayIndexOutOfBoundsException
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.