Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

ArrayIndexOutOfBoundsException — indeks polja zunaj obsega

ArrayIndexOutOfBoundsException sporoča, da je bil uporabljen indeks polja, ki je negativen ali večji oziroma enak dolžini polja. Veljaven indeks izpolnjuje pogoj 0 <= index && index < array.length.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

array[index]
new ArrayIndexOutOfBoundsException()
new ArrayIndexOutOfBoundsException(index)
new ArrayIndexOutOfBoundsException(s)

ArrayIndexOutOfBoundsException označuje poskus dostopa do elementa polja zunaj njegovih meja. V nepraznem polju so indeksi od 0 do array.length - 1; prazno polje nima veljavnega indeksa. Java preverja meje med izvajanjem. Pri branju prek reference null se namesto tega sproži NullPointerException.

Razred razširja IndexOutOfBoundsException in posredno RuntimeException, zato gre za nenadzorovano izjemo: ni je treba ujeti ali navesti v throws. IndexOutOfBoundsException je splošnejša vrsta napake pri indeksiranju in ni omejena na polja.

Konstruktorji so ArrayIndexOutOfBoundsException(), ArrayIndexOutOfBoundsException(int index) in ArrayIndexOutOfBoundsException(String s): brez sporočila, z neveljavnim indeksom oziroma z navedenim sporočilom. Oblika sporočila pri različici int ni določena; testov ne zasnuj na njej.

Napako preprečiš s preverjanjem 0 <= index && index < array.length; v zanki uporabi index < array.length, ne index <= array.length. Primer namenoma ujame izjemo, da pokaže napako za ena: values.length je že zunaj polja. V običajni kodi popravi izračun indeksa, namesto da napako prikriješ z ujetjem izjeme.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri