Метод checkIndex

Метод checkIndex класса Objects проверяет, что переданный индекс находится в допустимых пределах для последовательности заданной длины. В первый параметр мы передаем проверяемый индекс, во второй - длину последовательности (например, длину массива или коллекции). Если индекс меньше нуля или больше либо равен длине, метод выбрасывает исключение IndexOutOfBoundsException. Если индекс корректен, метод возвращает его же, что позволяет использовать его прямо в выражениях.

Синтаксис

Objects.checkIndex(index, length)

Пример

Давайте проверим корректный индекс 2 для последовательности длиной 5:

import java.util.Objects;

public class Main
{
	public static void main(String[] args)
	{
		int index = 2;
		int length = 5;
		int res = Objects.checkIndex(index, length);
		System.out.println(res);
	}
}

Результат выполнения кода:

2

Пример

Давайте попробуем проверить некорректный индекс 7 для последовательности длиной 5. Метод выбросит исключение IndexOutOfBoundsException:

import java.util.Objects;

public class Main
{
	public static void main(String[] args)
	{
		try
		{
			int index = 7;
			int length = 5;
			int res = Objects.checkIndex(index, length);
			System.out.println(res);
		}
		catch (IndexOutOfBoundsException e)
		{
			System.out.println("Index out of bounds");
		}
	}
}

Результат выполнения кода:

"Index out of bounds"

Пример

Давайте проверим отрицательный индекс -1 для последовательности длиной 5. Метод также выбросит исключение IndexOutOfBoundsException:

import java.util.Objects;

public class Main
{
	public static void main(String[] args)
	{
		try
		{
			int index = -1;
			int length = 5;
			int res = Objects.checkIndex(index, length);
			System.out.println(res);
		}
		catch (IndexOutOfBoundsException e)
		{
			System.out.println("Index out of bounds");
		}
	}
}

Результат выполнения кода:

"Index out of bounds"

Смотрите также

метод checkFromToIndex,
который проверяет диапазон индексов
класс IndexOutOfBoundsException,
которое выбрасывается при выходе за границы
метод requireNonNull,
который проверяет ссылку на null
метод equals,
который сравнивает объекты безопасно