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.