Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori