CKTIS / Java
IndexOutOfBoundsException — index buiten het geldige bereik
IndexOutOfBoundsException geeft aan dat een index buiten het toegestane bereik valt. Leer hoe deze uitzondering zich verhoudt tot RuntimeException, welke gespecialiseerde subklassen er zijn en hoe je een array-index expliciet controleert.
Versie: 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 geeft aan dat een index buiten het bereik valt dat een bewerking toestaat. De klasse erft van RuntimeException en is dus een ongecontroleerde uitzondering: de compiler vereist niet dat je deze opvangt of met throws declareert.
Bij toegang tot een array-element is een index geldig als 0 <= index && index < values.length geldt. Een index die gelijk is aan de lengte is al ongeldig; een lege array heeft geen geldige indexen. Rechtstreekse toegang tot een array met een ongeldige index veroorzaakt ArrayIndexOutOfBoundsException. Die klasse en StringIndexOutOfBoundsException zijn subklassen van IndexOutOfBoundsException. Een catch-blok voor de basisklasse vangt deze uitzonderingen dus ook op.
De constructors accepteren geen argumenten of een argument van het type String, int of long. De numerieke varianten nemen de index op in het bericht, maar de precieze indeling ervan is niet vastgelegd. Laat de programmalogica niet afhangen van het parseren van die berichten.
Het voorbeeld controleert de grenzen expliciet en veroorzaakt de uitzondering met een aangepast bericht. Het opvangen dient ter demonstratie; corrigeer in gewone code de berekening van de index of controleer deze bij de API-grens, in plaats van de uitzondering te negeren en met ongeldige aannames verder te gaan.
Voorbeelden
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());
}
}
}Resultaat
20 Invalid index: 2
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.