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

CKTIS / Java

IndexOutOfBoundsException — индекс извън валидния диапазон

IndexOutOfBoundsException сигнализира за индекс извън разрешения диапазон. Научете каква е връзката ѝ с RuntimeException, кои са специализираните ѝ подкласове и как изрично да проверявате индекс на масив.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

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

java.lang.IndexOutOfBoundsException сигнализира за индекс извън диапазона, разрешен от дадена операция. Тя наследява RuntimeException и затова е непроверено изключение: компилаторът не изисква да го прихващате или да го декларирате с throws.

При достъп до елемент на масив индексът е валиден, ако е изпълнено 0 <= index && index < values.length. Индекс, равен на дължината, вече е невалиден; празният масив няма валидни индекси. Прекият достъп до масив с невалиден индекс хвърля ArrayIndexOutOfBoundsException. Този клас и StringIndexOutOfBoundsException са подкласове на IndexOutOfBoundsException, затова блок catch за базовия клас прихваща и тези изключения.

Конструкторите не приемат аргументи или приемат аргумент от тип String, int или long. Числовите варианти включват индекса в съобщението, но точният му формат не е зададен. Не изграждайте логиката на програмата върху разчитането на тези съобщения.

Примерът изрично проверява границите и хвърля изключението с персонализирано съобщение. Прихващането е с демонстрационна цел; в обичайния код коригирайте изчисляването на индекса или го проверявайте на границата на API, вместо да игнорирате изключението и да продължавате с невалидни предположения.

Примери

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());
        }
    }
}

Резултат

20
Invalid index: 2

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

Източници