CKTIS / Java
ArrayIndexOutOfBoundsException — indeks polja izvan raspona
ArrayIndexOutOfBoundsException označava pristup polju s negativnim indeksom ili indeksom koji je veći ili jednak duljini polja. Valjani indeks zadovoljava uvjet 0 <= index && index < array.length.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
array[index]
new ArrayIndexOutOfBoundsException()
new ArrayIndexOutOfBoundsException(index)
new ArrayIndexOutOfBoundsException(s)ArrayIndexOutOfBoundsException označava pokušaj pristupa elementu polja izvan njegovih granica. U nepraznom polju indeksi se protežu od 0 do array.length - 1; prazno polje nema valjan indeks. Java provjerava granice tijekom izvođenja. Čitanje putem reference null umjesto toga izaziva NullPointerException.
Klasa nasljeđuje IndexOutOfBoundsException i posredno RuntimeException, pa je riječ o nekontroliranoj iznimci: ne morate je uhvatiti ni navesti u throws. IndexOutOfBoundsException općenitija je vrsta pogreške indeksiranja i nije ograničena na polja.
Konstruktori su ArrayIndexOutOfBoundsException(), ArrayIndexOutOfBoundsException(int index) i ArrayIndexOutOfBoundsException(String s): redom bez poruke, s nevaljanim indeksom i sa zadanom porukom. Format poruke za varijantu int nije određen; nemojte na njemu temeljiti testove.
Da biste spriječili pogrešku, provjerite 0 <= index && index < array.length; u petlji koristite index < array.length, a ne index <= array.length. Primjer namjerno hvata iznimku kako bi pokazao pogrešku za jedan: values.length već je izvan polja. U uobičajenom kodu ispravite izračun indeksa umjesto da pogrešku skrivate hvatanjem iznimke.
Primjeri
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");
}
}
}Rezultat
30 ArrayIndexOutOfBoundsException
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.