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.