CKTIS / Java
ArrayIndexOutOfBoundsException — индекс на масив извън границите
ArrayIndexOutOfBoundsException сигнализира за достъп до масив с отрицателен индекс или с индекс, който е по-голям или равен на дължината на масива. Валидният индекс удовлетворява 0 <= index && index < array.length.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
array[index]
new ArrayIndexOutOfBoundsException()
new ArrayIndexOutOfBoundsException(index)
new ArrayIndexOutOfBoundsException(s)ArrayIndexOutOfBoundsException означава опит за достъп до елемент на масив извън границите му. При непразен масив индексите са от 0 до array.length - 1; празният масив няма валиден индекс. Java проверява границите по време на изпълнение. При четене чрез референция null вместо това се хвърля NullPointerException.
Класът наследява IndexOutOfBoundsException и косвено RuntimeException, затова е непроверявано изключение: не е необходимо да го прихващате или декларирате в throws. IndexOutOfBoundsException е по-общ тип грешка при индексиране и не се ограничава до масиви.
Конструкторите са ArrayIndexOutOfBoundsException(), ArrayIndexOutOfBoundsException(int index) и ArrayIndexOutOfBoundsException(String s): съответно без съобщение, с невалидния индекс и с подадено съобщение. Форматът на съобщението за варианта int не е определен; не основавайте тестовете си на него.
За да предотвратите грешката, проверявайте 0 <= index && index < array.length; в цикъл използвайте index < array.length, а не index <= array.length. Примерът умишлено прихваща изключението, за да покаже грешка с единица: values.length вече е извън масива. В обикновен код поправете изчисляването на индекса, вместо да прикривате грешката чрез прихващане на изключението.
Примери
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");
}
}
}Резултат
30 ArrayIndexOutOfBoundsException
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.