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

CKTIS / Java

IndexOutOfBoundsException — índice fora do intervalo válido

IndexOutOfBoundsException assinala um índice fora do intervalo permitido. Saiba qual a sua relação com RuntimeException, quais as suas subclasses especializadas e como validar explicitamente um índice de um array.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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

java.lang.IndexOutOfBoundsException assinala um índice fora do intervalo permitido por uma operação. Estende RuntimeException, pelo que é uma exceção não verificada: o compilador não exige que a capture nem que a declare com throws.

Para aceder a um elemento de um array, o índice é válido se satisfizer 0 <= index && index < values.length. Um índice igual ao comprimento já é inválido; um array vazio não tem índices válidos. O acesso direto a um array com um índice inválido lança ArrayIndexOutOfBoundsException. Essa classe e StringIndexOutOfBoundsException estendem IndexOutOfBoundsException, pelo que um bloco catch para a classe base também captura estas exceções.

Os construtores não aceitam argumentos ou aceitam um argumento do tipo String, int ou long. As versões numéricas incluem o índice na mensagem, mas o seu formato exato não está especificado. Não faças a lógica do programa depender da análise dessas mensagens.

O exemplo verifica explicitamente os limites e lança a exceção com uma mensagem personalizada. A captura serve para demonstrar; no código normal, corrige o cálculo do índice ou valida-o no limite da API, em vez de ignorar a exceção e continuar com pressupostos inválidos.

Exemplos

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

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