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.