Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

IndexOutOfBoundsException — index mimo platný rozsah

IndexOutOfBoundsException signalizuje index mimo povolený rozsah. Zistite, ako súvisí s RuntimeException, ktoré má špecializované podtriedy a ako výslovne overiť index poľa.

Verzia: Java SE 21; repository runtime, production runtime not attested

Syntax

public IndexOutOfBoundsException()
public IndexOutOfBoundsException(String message)
public IndexOutOfBoundsException(int index)
public IndexOutOfBoundsException(long index)

java.lang.IndexOutOfBoundsException signalizuje index mimo rozsahu povoleného danou operáciou. Dedičnosťou vychádza z RuntimeException, takže ide o nekontrolovanú výnimku: kompilátor nevyžaduje, aby ste ju zachytili alebo deklarovali pomocou throws.

Pri prístupe k prvku poľa je index platný, ak spĺňa 0 <= index && index < values.length. Index rovný dĺžke je už neplatný; prázdne pole nemá žiadne platné indexy. Priamy prístup k poľu s neplatným indexom vyvolá ArrayIndexOutOfBoundsException. Táto trieda a StringIndexOutOfBoundsException dedia z IndexOutOfBoundsException, preto blok catch pre základnú triedu zachytí aj tieto výnimky.

Konštruktory neprijímajú žiadne argumenty alebo prijímajú argument typu String, int či long. Číselné varianty uvádzajú index v správe, jej presný formát však nie je špecifikovaný. Nezakladajte logiku programu na parsovaní týchto správ.

Príklad výslovne kontroluje hranice a vyvolá výnimku s vlastnou správou. Zachytenie slúži na demonštráciu; v bežnom kóde opravte výpočet indexu alebo ho overte na hranici API, namiesto ignorovania výnimky a pokračovania s neplatnými predpokladmi.

Príklady

public class Main {
    static int read(int[] values, int index) {
        if (index < 0 || index >= values.length) {
            throw new IndexOutOfBoundsException("Invalid index: " + index);
        }
        return values[index];
    }

    public static void main(String[] args) {
        int[] values = {10, 20};
        System.out.println(read(values, 1));
        try {
            System.out.println(read(values, 2));
        } catch (IndexOutOfBoundsException e) {
            System.out.println(e.getMessage());
        }
    }
}

Výsledok

20
Invalid index: 2

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje