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.