Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje