CKTIS / Java
IndexOutOfBoundsException — indeks zunaj veljavnega obsega
IndexOutOfBoundsException označuje indeks zunaj dovoljenega obsega. Spoznajte njeno povezavo z RuntimeException, njene specializirane podrazrede in način izrecnega preverjanja indeksa polja.
Različica: 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čuje indeks zunaj obsega, ki ga dovoljuje operacija. Podeduje razred RuntimeException, zato gre za nepreverjeno izjemo: prevajalnik ne zahteva, da jo ujamete ali navedete z throws.
Pri dostopu do elementa polja je indeks veljaven, če izpolnjuje pogoj 0 <= index && index < values.length. Indeks, enak dolžini, je že neveljaven; prazno polje nima veljavnih indeksov. Neposreden dostop do polja z neveljavnim indeksom sproži ArrayIndexOutOfBoundsException. Ta razred in StringIndexOutOfBoundsException sta podrazreda IndexOutOfBoundsException, zato blok catch za osnovni razred ujame tudi ti izjemi.
Konstruktorji ne sprejmejo nobenega argumenta ali pa sprejmejo argument vrste String, int ali long. Številske različice vključijo indeks v sporočilo, vendar njegova natančna oblika ni določena. Logike programa ne vežite na razčlenjevanje teh sporočil.
Primer izrecno preveri meje in sproži izjemo z lastnim sporočilom. Ujemanje izjeme je namenjeno prikazu; v običajni kodi popravite izračun indeksa ali ga preverite na meji API-ja, namesto da izjemo prezrete in nadaljujete z neveljavnimi predpostavkami.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.