CKTIS / Java
ArrayIndexOutOfBoundsException — índice de array fuera de rango
ArrayIndexOutOfBoundsException indica un acceso a un array con un índice negativo o mayor o igual que la longitud del array. Un índice válido cumple 0 <= index && index < array.length.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
array[index]
new ArrayIndexOutOfBoundsException()
new ArrayIndexOutOfBoundsException(index)
new ArrayIndexOutOfBoundsException(s)ArrayIndexOutOfBoundsException indica un intento de acceder a un elemento del array fuera de sus límites. En un array no vacío, los índices van de 0 a array.length - 1; un array vacío no tiene ningún índice válido. Java comprueba los límites durante la ejecución. En cambio, al leer mediante una referencia null, se lanza NullPointerException.
La clase extiende IndexOutOfBoundsException y, de forma indirecta, RuntimeException, por lo que es una excepción no comprobada: no es necesario capturarla ni declararla en throws. IndexOutOfBoundsException es un tipo de error de indexación más general, que no se limita a los arrays.
Los constructores son ArrayIndexOutOfBoundsException(), ArrayIndexOutOfBoundsException(int index) y ArrayIndexOutOfBoundsException(String s): respectivamente, sin mensaje, con el índice no válido y con un mensaje proporcionado. El formato del mensaje de la variante int no está especificado; no bases las pruebas en él.
Para evitar el error, comprueba 0 <= index && index < array.length; en un bucle, usa index < array.length, no index <= array.length. El ejemplo captura deliberadamente la excepción para mostrar un error de uno más: values.length ya está fuera del array. En código normal, corrige el cálculo del índice en lugar de ocultar el error capturando la excepción.
Ejemplos
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");
}
}
}Resultado
30 ArrayIndexOutOfBoundsException
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.