Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

IndexOutOfBoundsException — índice fuera del rango válido

IndexOutOfBoundsException indica que un índice está fuera del rango permitido. Aprende su relación con RuntimeException, sus subclases especializadas y cómo validar explícitamente el índice de un array.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

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

java.lang.IndexOutOfBoundsException indica que un índice está fuera del rango permitido por una operación. Extiende RuntimeException, por lo que es una excepción no comprobada: el compilador no exige que la captures ni que la declares con throws.

Para acceder a un elemento de un array, el índice es válido si cumple 0 <= index && index < values.length. Un índice igual a la longitud ya es inválido; un array vacío no tiene índices válidos. El acceso directo a un array con un índice inválido lanza ArrayIndexOutOfBoundsException. Esa clase y StringIndexOutOfBoundsException extienden IndexOutOfBoundsException, así que un bloque catch para la clase base también captura estas excepciones.

Los constructores no aceptan argumentos o aceptan uno de tipo String, int o long. Las variantes numéricas incluyen el índice en el mensaje, pero su formato exacto no está especificado. No hagas que la lógica del programa dependa de analizar esos mensajes.

El ejemplo comprueba explícitamente los límites y lanza la excepción con un mensaje personalizado. La captura tiene una finalidad demostrativa; en el código habitual, corrige el cálculo del índice o valídalo en el límite de la API, en lugar de ignorar la excepción y continuar con suposiciones inválidas.

Ejemplos

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

Resultado

20
Invalid index: 2

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes