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.