KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

ArrayIndexOutOfBoundsException — array-index buiten de grenzen

ArrayIndexOutOfBoundsException geeft aan dat een array wordt benaderd met een negatieve index of een index die groter dan of gelijk aan de arraylengte is. Een geldige index voldoet aan 0 <= index && index < array.length.

Versie: Java SE 21; repository runtime, production runtime not attested

Syntax

array[index]
new ArrayIndexOutOfBoundsException()
new ArrayIndexOutOfBoundsException(index)
new ArrayIndexOutOfBoundsException(s)

ArrayIndexOutOfBoundsException geeft aan dat er wordt geprobeerd een array-element buiten de grenzen van de array te benaderen. Bij een niet-lege array lopen de indices van 0 tot array.length - 1; een lege array heeft geen geldige index. Java controleert de grenzen tijdens de uitvoering. Lezen via een null-verwijzing veroorzaakt daarentegen NullPointerException.

De klasse breidt IndexOutOfBoundsException en indirect RuntimeException uit en is dus een ongecontroleerde uitzondering: je hoeft deze niet af te vangen of in throws te declareren. IndexOutOfBoundsException is een algemener type indexeringsfout en is niet beperkt tot arrays.

De constructors zijn ArrayIndexOutOfBoundsException(), ArrayIndexOutOfBoundsException(int index) en ArrayIndexOutOfBoundsException(String s): respectievelijk zonder bericht, met de ongeldige index en met een opgegeven bericht. De berichtindeling voor de int-variant is niet vastgelegd; baseer tests er niet op.

Controleer 0 <= index && index < array.length om de fout te voorkomen; gebruik in een lus index < array.length, niet index <= array.length. Het voorbeeld vangt de uitzondering bewust op om een off-by-one-fout te laten zien: values.length valt al buiten de array. Corrigeer in gewone code de berekening van de index in plaats van de fout te verbergen door de uitzondering af te vangen.

Voorbeelden

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

Resultaat

30
ArrayIndexOutOfBoundsException

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.

Bronnen