База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници