CKTIS / Java
ArrayIndexOutOfBoundsException — Arrayindex außerhalb des gültigen Bereichs
ArrayIndexOutOfBoundsException signalisiert den Zugriff auf ein Array mit einem negativen Index oder einem Index, der mindestens so groß wie die Arraylänge ist. Ein gültiger Index erfüllt 0 <= index && index < array.length.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
array[index]
new ArrayIndexOutOfBoundsException()
new ArrayIndexOutOfBoundsException(index)
new ArrayIndexOutOfBoundsException(s)ArrayIndexOutOfBoundsException weist auf den Versuch hin, auf ein Arrayelement außerhalb seiner Grenzen zuzugreifen. Bei einem nicht leeren Array reichen die Indizes von 0 bis array.length - 1; ein leeres Array hat keinen gültigen Index. Java prüft die Grenzen zur Laufzeit. Beim Lesen über eine null-Referenz wird stattdessen NullPointerException ausgelöst.
Die Klasse erweitert IndexOutOfBoundsException und mittelbar RuntimeException und ist daher eine ungeprüfte Ausnahme: Sie muss weder abgefangen noch in throws deklariert werden. IndexOutOfBoundsException ist ein allgemeinerer Typ für Indexfehler und nicht auf Arrays beschränkt.
Die Konstruktoren sind ArrayIndexOutOfBoundsException(), ArrayIndexOutOfBoundsException(int index) und ArrayIndexOutOfBoundsException(String s): jeweils ohne Meldung, mit dem ungültigen Index oder mit einer angegebenen Meldung. Das Format der Meldung für die int-Variante ist nicht festgelegt; Tests sollten sich nicht darauf stützen.
Um den Fehler zu vermeiden, prüfe 0 <= index && index < array.length; verwende in einer Schleife index < array.length und nicht index <= array.length. Das Beispiel fängt die Ausnahme absichtlich ab, um einen Off-by-one-Fehler zu zeigen: values.length liegt bereits außerhalb des Arrays. Im normalen Code solltest du die Indexberechnung korrigieren, statt den Fehler durch Abfangen der Ausnahme zu verbergen.
Beispiele
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");
}
}
}Ergebnis
30 ArrayIndexOutOfBoundsException
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.