Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

IndexOutOfBoundsException — index en dehors de la plage valide

IndexOutOfBoundsException signale un index en dehors de la plage autorisée. Découvrez son lien avec RuntimeException, ses sous-classes spécialisées et comment vérifier explicitement un index de tableau.

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

Syntaxe

public IndexOutOfBoundsException()
public IndexOutOfBoundsException(String message)
public IndexOutOfBoundsException(int index)
public IndexOutOfBoundsException(long index)

java.lang.IndexOutOfBoundsException signale un index en dehors de la plage autorisée par une opération. Cette classe étend RuntimeException et correspond donc à une exception non vérifiée : le compilateur n’exige pas que vous l’interceptiez ni que vous la déclariez avec throws.

Pour accéder à un élément de tableau, un index est valide si 0 <= index && index < values.length. Un index égal à la longueur est déjà invalide ; un tableau vide n’a aucun index valide. Un accès direct au tableau avec un index invalide déclenche ArrayIndexOutOfBoundsException. Cette classe et StringIndexOutOfBoundsException étendent IndexOutOfBoundsException : un bloc catch portant sur la classe de base intercepte donc également ces exceptions.

Les constructeurs n’acceptent aucun argument ou acceptent un argument de type String, int ou long. Les versions numériques incluent l’index dans le message, mais son format exact n’est pas spécifié. Ne faites pas dépendre la logique du programme de l’analyse de ces messages.

L’exemple vérifie explicitement les limites et déclenche l’exception avec un message personnalisé. L’interception sert à la démonstration ; dans du code courant, corrigez le calcul de l’index ou vérifiez-le à la frontière de l’API, plutôt que d’ignorer l’exception et de poursuivre avec des hypothèses invalides.

Exemples

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

Résultat

20
Invalid index: 2

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources