CKTIS / Java
ArrayIndexOutOfBoundsException — index pole mimo rozsah
ArrayIndexOutOfBoundsException signalizuje přístup k poli se záporným indexem nebo s indexem větším či rovným délce pole. Platný index splňuje 0 <= index && index < array.length.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
array[index]
new ArrayIndexOutOfBoundsException()
new ArrayIndexOutOfBoundsException(index)
new ArrayIndexOutOfBoundsException(s)ArrayIndexOutOfBoundsException označuje pokus o přístup k prvku pole mimo jeho rozsah. U neprázdného pole jsou indexy od 0 do array.length - 1; prázdné pole nemá žádný platný index. Java kontroluje rozsah za běhu. Při čtení přes referenci null se místo toho vyvolá NullPointerException.
Třída dědí z IndexOutOfBoundsException a nepřímo z RuntimeException, takže jde o nekontrolovanou výjimku: není nutné ji zachytit ani deklarovat v throws. IndexOutOfBoundsException je obecnější typ chyby indexování, který se neomezuje jen na pole.
Konstruktory jsou ArrayIndexOutOfBoundsException(), ArrayIndexOutOfBoundsException(int index) a ArrayIndexOutOfBoundsException(String s): postupně bez zprávy, s neplatným indexem a s dodanou zprávou. Formát zprávy u varianty int není určen; nezakládejte na něm testy.
Chcete-li chybě předejít, kontrolujte 0 <= index && index < array.length; ve smyčce používejte index < array.length, nikoli index <= array.length. Příklad výjimku záměrně zachytává, aby ukázal chybu o jedničku: values.length už leží mimo pole. V běžném kódu opravte výpočet indexu místo toho, abyste chybu skryli zachycením výjimky.
Příklady
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");
}
}
}Výsledek
30 ArrayIndexOutOfBoundsException
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.