CKTIS / Java
IndexOutOfBoundsException — index mimo platný rozsah
IndexOutOfBoundsException signalizuje index mimo povolený rozsah. Seznamte se s jejím vztahem k RuntimeException, specializovanými podtřídami a způsobem, jak výslovně ověřit index pole.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
public IndexOutOfBoundsException()
public IndexOutOfBoundsException(String message)
public IndexOutOfBoundsException(int index)
public IndexOutOfBoundsException(long index)java.lang.IndexOutOfBoundsException signalizuje index mimo rozsah povolený danou operací. Dědí z RuntimeException, takže jde o nekontrolovanou výjimku: kompilátor nevyžaduje, abyste ji zachytili nebo deklarovali pomocí throws.
Při přístupu k prvku pole je index platný, pokud splňuje 0 <= index && index < values.length. Index rovný délce je už neplatný; prázdné pole nemá žádné platné indexy. Přímý přístup k poli s neplatným indexem vyvolá ArrayIndexOutOfBoundsException. Tato třída a StringIndexOutOfBoundsException dědí z IndexOutOfBoundsException, takže blok catch pro základní třídu zachytí i tyto výjimky.
Konstruktory nepřijímají žádné argumenty nebo přijímají argument typu String, int či long. Číselné varianty zahrnují index do zprávy, její přesný formát však není specifikován. Nezakládejte logiku programu na parsování těchto zpráv.
Příklad výslovně kontroluje hranice a vyvolá výjimku s vlastní zprávou. Zachycení slouží k demonstraci; v běžném kódu opravte výpočet indexu nebo jej ověřte na hranici API, místo abyste výjimku ignorovali a pokračovali s neplatnými předpoklady.
Pří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ýsledek
20 Invalid index: 2
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.