Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

IndexOutOfBoundsException — indeks izvan valjanog raspona

IndexOutOfBoundsException označava indeks izvan dopuštenog raspona. Saznajte kako je povezana s RuntimeException, koje su njezine specijalizirane podklase i kako izričito provjeriti indeks polja.

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

Sintaksa

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

java.lang.IndexOutOfBoundsException označava indeks izvan raspona koji dopušta neka operacija. Nasljeđuje RuntimeException, pa je riječ o neprovjerenoj iznimci: prevoditelj ne zahtijeva da je uhvatite ni da je deklarirate pomoću throws.

Pri pristupu elementu polja indeks je valjan ako vrijedi 0 <= index && index < values.length. Indeks jednak duljini već je nevaljan; prazno polje nema valjanih indeksa. Izravan pristup polju s nevaljanim indeksom izbacuje ArrayIndexOutOfBoundsException. Ta klasa i StringIndexOutOfBoundsException podklase su klase IndexOutOfBoundsException, pa blok catch za osnovnu klasu hvata i te iznimke.

Konstruktori ne prihvaćaju argumente ili prihvaćaju argument vrste String, int ili long. Brojčane inačice uključuju indeks u poruku, ali njezin točan format nije specificiran. Nemojte temeljiti logiku programa na parsiranju tih poruka.

Primjer izričito provjerava granice i izbacuje iznimku s prilagođenom porukom. Hvatanje služi za demonstraciju; u uobičajenom kodu ispravite izračun indeksa ili ga provjerite na granici API-ja, umjesto da zanemarite iznimku i nastavite s nevaljanim pretpostavkama.

Primjeri

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());
        }
    }
}

Rezultat

20
Invalid index: 2

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori