CKTIS / Java
ArrayIndexOutOfBoundsException — index poľa mimo rozsahu
ArrayIndexOutOfBoundsException signalizuje prístup k poľu so záporným indexom alebo s indexom väčším či rovným dĺžke poľa. Platný index spĺňa 0 <= index && index < array.length.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
array[index]
new ArrayIndexOutOfBoundsException()
new ArrayIndexOutOfBoundsException(index)
new ArrayIndexOutOfBoundsException(s)ArrayIndexOutOfBoundsException označuje pokus o prístup k prvku poľa mimo jeho rozsahu. V neprázdnom poli sú indexy od 0 po array.length - 1; prázdne pole nemá platný index. Java kontroluje rozsah počas behu. Pri čítaní cez referenciu null sa namiesto toho vyvolá NullPointerException.
Trieda rozširuje IndexOutOfBoundsException a nepriamo RuntimeException, takže ide o nekontrolovanú výnimku: netreba ju zachytiť ani deklarovať v throws. IndexOutOfBoundsException je všeobecnejší typ chyby indexovania, ktorý sa neobmedzuje na polia.
Konštruktory sú ArrayIndexOutOfBoundsException(), ArrayIndexOutOfBoundsException(int index) a ArrayIndexOutOfBoundsException(String s): postupne bez správy, s neplatným indexom a so zadanou správou. Formát správy pri variante int nie je určený; nezakladajte na ňom testy.
Ak chcete chybe predísť, kontrolujte 0 <= index && index < array.length; v cykle používajte index < array.length, nie index <= array.length. Príklad výnimku zámerne zachytáva, aby ukázal chybu o jedna: values.length je už mimo poľa. V bežnom kóde opravte výpočet indexu namiesto toho, aby ste chybu skryli zachytením výnimky.
Prí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ýsledok
30 ArrayIndexOutOfBoundsException
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.