WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

IndexOutOfBoundsException — Index außerhalb des gültigen Bereichs

IndexOutOfBoundsException signalisiert einen Index außerhalb des zulässigen Bereichs. Erfahre, wie die Ausnahme mit RuntimeException zusammenhängt, welche spezialisierten Unterklassen es gibt und wie du einen Array-Index ausdrücklich prüfst.

Version: 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 signalisiert einen Index außerhalb des Bereichs, den eine Operation zulässt. Die Klasse erbt von RuntimeException und ist damit eine ungeprüfte Ausnahme: Der Compiler verlangt weder, dass du sie abfängst, noch, dass du sie mit throws deklarierst.

Beim Zugriff auf ein Array-Element ist ein Index gültig, wenn 0 <= index && index < values.length gilt. Ein Index, der der Länge entspricht, ist bereits ungültig; ein leeres Array hat keine gültigen Indizes. Ein direkter Array-Zugriff mit einem ungültigen Index löst ArrayIndexOutOfBoundsException aus. Diese Klasse und StringIndexOutOfBoundsException sind Unterklassen von IndexOutOfBoundsException; ein catch-Block für die Basisklasse fängt daher auch diese Ausnahmen ab.

Die Konstruktoren akzeptieren keine Argumente oder ein Argument vom Typ String, int oder long. Die numerischen Varianten nehmen den Index in die Meldung auf, sein genaues Format ist jedoch nicht festgelegt. Mache die Programmlogik nicht davon abhängig, diese Meldungen zu parsen.

Das Beispiel prüft die Grenzen ausdrücklich und löst die Ausnahme mit einer eigenen Meldung aus. Das Abfangen dient der Veranschaulichung. Korrigiere im normalen Code die Indexberechnung oder prüfe den Index an der API-Grenze, statt die Ausnahme zu ignorieren und mit ungültigen Annahmen fortzufahren.

Beispiele

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());
        }
    }
}

Ergebnis

20
Invalid index: 2

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen