PRIOR и NEXT

📖 Описание

Методы PRIOR(n) и NEXT(n) возвращают индексы предыдущего и следующего существующих элементов относительно n. Удалённые элементы пропускаются. Если соседа в выбранном направлении нет, результат равен NULL.
Поэтому для инициализированной коллекции c выражения c.PRIOR(c.FIRST) и c.NEXT(c.LAST) возвращают NULL. Сам индекс n не обязан существовать. Методы удобны для обхода разреженных коллекций.


🧩 Синтаксис

Синтаксис методов коллекций PRIOR и NEXT в Oracle PL/SQL.

previous_index := collection_name.PRIOR(n);
next_index := collection_name.NEXT(n);

⚙️ Параметры и аргументы

collection_name — переменная коллекции.
n — исходный индекс.
previous_index и next_index — индексы соседей, а не значения элементов. Тип переменных должен соответствовать типу ключей коллекции.


📝 Примечание

  • Смотрите также методы коллекций: LIMIT, COUNT, FIRST и LAST, EXISTS, EXTEND, TRIM, DELETE.
  • В Varray при индексе выше LIMIT метод PRIOR возвращает LAST, а NEXT — NULL.
  • Для массива со строковыми ключами соседние индексы определяются порядком сортировки ключей.
  • Для NULL-коллекции метод вызывает COLLECTION_IS_NULL. Это отличается от инициализированной пустой коллекции.

💻 Соседи существующих и удалённых индексов

Стоимость пяти наборов хранится во вложенной таблице. Третий элемент удалён, второй существует со значением NULL. Проверим соседей для индексов от 1 до 6, включая отсутствующие 3 и 6.

DECLARE
  TYPE fee_list IS TABLE OF NUMBER;
  v_fees fee_list := fee_list(45, NULL, 75, 90, 120);
BEGIN
  v_fees.DELETE(3);
  FOR i IN 1 .. 6 LOOP
    DBMS_OUTPUT.PUT_LINE(i || ': prior=' || NVL(TO_CHAR(v_fees.PRIOR(i)), 'NULL') ||
      ', next=' || NVL(TO_CHAR(v_fees.NEXT(i)), 'NULL'));
  END LOOP;
END;
/
Индекс n PRIOR(n) NEXT(n)
1 NULL 2
2 1 4
3 2 4
4 2 5
5 4 NULL
6 5 NULL

Для отсутствующего индекса 3 методы возвращают существующих соседей 2 и 4. Значение NULL элемента 2 не мешает ему участвовать в обходе.

💻 Обход вперёд и назад

Ниже полный самостоятельный блок на тех же данных. Удалённый индекс пропускается в обоих направлениях.

DECLARE
  TYPE fee_list IS TABLE OF NUMBER;
  v_fees fee_list := fee_list(45, NULL, 75, 90, 120);
  v_index PLS_INTEGER;
BEGIN
  v_fees.DELETE(3);
  DBMS_OUTPUT.PUT_LINE('Forward');
  v_index := v_fees.FIRST;
  WHILE v_index IS NOT NULL LOOP
    DBMS_OUTPUT.PUT_LINE(v_index || ': ' || NVL(TO_CHAR(v_fees(v_index)), 'NULL'));
    v_index := v_fees.NEXT(v_index);
  END LOOP;
  DBMS_OUTPUT.PUT_LINE('Backward');
  v_index := v_fees.LAST;
  WHILE v_index IS NOT NULL LOOP
    DBMS_OUTPUT.PUT_LINE(v_index || ': ' || NVL(TO_CHAR(v_fees(v_index)), 'NULL'));
    v_index := v_fees.PRIOR(v_index);
  END LOOP;
END;
/
-- Forward
-- 1: 45
-- 2: NULL
-- 4: 90
-- 5: 120
-- Backward
-- 5: 120
-- 4: 90
-- 2: NULL
-- 1: 45

При пустой инициализированной коллекции FIRST и LAST равны NULL, поэтому оба WHILE пропускаются. Диапазон 1 .. COUNT не подходит для этой разреженной таблицы: он захватил бы удалённый индекс 3 и пропустил бы индекс 5.

Для просмотра строк включите DBMS Output в клиенте; в SQL*Plus/SQLcl выполните SET SERVEROUTPUT ON. Ожидаемый вывод рассчитан для указанных данных.

Документация Oracle 19c: Collection Methods, Collection Method Invocation.