CKTIS / Java
IndexOutOfBoundsException — indeks poza zakresem
IndexOutOfBoundsException sygnalizuje indeks spoza dozwolonego zakresu. Poznaj jego relację z RuntimeException, wyspecjalizowane podklasy oraz sposób jawnego sprawdzania indeksu tablicy.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
public IndexOutOfBoundsException()
public IndexOutOfBoundsException(String message)
public IndexOutOfBoundsException(int index)
public IndexOutOfBoundsException(long index)java.lang.IndexOutOfBoundsException sygnalizuje indeks spoza zakresu dozwolonego przez daną operację. Dziedziczy po RuntimeException, więc jest wyjątkiem niekontrolowanym: kompilator nie wymaga jego przechwycenia ani deklaracji throws.
Przy odczycie elementu tablicy poprawny indeks spełnia 0 <= index && index < values.length. Indeks równy długości jest już niepoprawny; pusta tablica nie ma poprawnych indeksów. Sam dostęp do tablicy z błędnym indeksem zgłasza ArrayIndexOutOfBoundsException. Ta klasa oraz StringIndexOutOfBoundsException są podklasami IndexOutOfBoundsException, więc blok catch dla klasy bazowej przechwytuje również te wyjątki.
Dostępne są konstruktory bez argumentów oraz z argumentem String, int albo long. Wersje liczbowe umieszczają indeks w komunikacie, ale nie gwarantują jego dokładnego formatu. Nie uzależniaj logiki programu od parsowania takich komunikatów.
Przykład jawnie sprawdza granice i zgłasza wyjątek z własnym komunikatem. Przechwycenie służy demonstracji; w zwykłym kodzie popraw obliczanie indeksu lub sprawdzaj go na granicy API, zamiast ignorować wyjątek i kontynuować z niepoprawnymi założeniami.
Przykłady
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());
}
}
}Wynik
20 Invalid index: 2
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.