Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes