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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.