CKTIS / Java
ArrayIndexOutOfBoundsException — índice do array fora dos limites
ArrayIndexOutOfBoundsException indica um acesso a um array com um índice negativo ou maior ou igual ao comprimento do array. Um índice válido satisfaz 0 <= index && index < array.length.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
array[index]
new ArrayIndexOutOfBoundsException()
new ArrayIndexOutOfBoundsException(index)
new ArrayIndexOutOfBoundsException(s)ArrayIndexOutOfBoundsException indica uma tentativa de aceder a um elemento do array fora dos seus limites. Num array não vazio, os índices vão de 0 a array.length - 1; um array vazio não tem índices válidos. O Java verifica os limites durante a execução. A leitura através de uma referência null lança, em vez disso, NullPointerException.
A classe estende IndexOutOfBoundsException e, indiretamente, RuntimeException, sendo por isso uma exceção não verificada: não é necessário capturá-la nem declará-la em throws. IndexOutOfBoundsException é um tipo de erro de indexação mais geral, não limitado a arrays.
Os construtores são ArrayIndexOutOfBoundsException(), ArrayIndexOutOfBoundsException(int index) e ArrayIndexOutOfBoundsException(String s): respetivamente, sem mensagem, com o índice inválido e com uma mensagem fornecida. O formato da mensagem para a variante int não está especificado; não baseies os testes nele.
Para evitar o erro, verifica 0 <= index && index < array.length; num ciclo, usa index < array.length, não index <= array.length. O exemplo captura deliberadamente a exceção para demonstrar um erro de uma unidade: values.length já está fora do array. Em código normal, corrige o cálculo do índice em vez de ocultar o erro ao capturar a exceção.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.