EXTEND
📖 Описание
В Oracle PL/SQL метод EXTEND - это процедура, которая добавляет элементы в конец Varray или Nested Tables. Коллекция может быть пустой, но должна быть инициализирована: NULL-коллекцию сначала создают конструктором.
🧩 Синтаксис
Синтаксис метода коллекций EXTEND в Oracle PL/SQL.
collection_name.EXTEND;
collection_name.EXTEND (n);
collection_name.EXTEND (n, i);
⚙️ Параметры и аргументы
collection_name — переменная Varray или Nested Tables.EXTEND добавляет один элемент со значением NULL.EXTEND(n) добавляет n элементов со значением NULL.EXTEND(n, i) добавляет n копий существующего элемента с индексом i.
📝 Примечание
- EXTEND (n, i) - единственная форма, которую вы можете использовать для коллекции, элементы которой имеют ограничение NOT NULL.
- EXTEND работает с внутренним размером коллекции. То есть, если DELETE удаляет элемент, но сохраняет его заполнитель, EXTEND учитывает это место во внутреннем размере, хотя EXISTS для удалённого элемента возвращает FALSE.
- Смотрите также методы коллекций: PRIOR и NEXT, LIMIT, COUNT, FIRST и LAST, EXISTS, TRIM, DELETE.
- Для ассоциативного массива EXTEND не используется: новый элемент создают присваиванием по ключу.
- У Varray число элементов после добавления не должно превышать LIMIT.
- Для NULL-коллекции метод вызывает COLLECTION_IS_NULL. Это отличается от инициализированной пустой коллекции.
💻 EXTEND: копирование, удалённый конец и NULL
Начнём с двух тарифов. Добавим три копии второго, удалим последний и затем вызовем EXTEND. Новый элемент займёт индекс 6, а не удалённый 5. Последний EXTEND(2) добавит ещё два NULL-элемента.
DECLARE
TYPE fee_list IS TABLE OF NUMBER;
v_fees fee_list := fee_list(80, 125);
PROCEDURE show_fees(p_label VARCHAR2) IS
v_index PLS_INTEGER;
BEGIN
DBMS_OUTPUT.PUT_LINE(p_label || ': COUNT=' || v_fees.COUNT);
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;
END;
BEGIN
show_fees('Initial');
v_fees.EXTEND(3, 2);
show_fees('Copies');
v_fees.DELETE(5);
v_fees.EXTEND;
show_fees('After deleted tail');
v_fees(6) := 150;
v_fees.EXTEND(2);
show_fees('Two more');
END;
/
| Этап | Существующие индексы и значения | COUNT / LAST |
|---|---|---|
| Initial | 1:80, 2:125 | 2 / 2 |
| Copies | 1:80, 2:125, 3:125, 4:125, 5:125 | 5 / 5 |
| After deleted tail | 1:80, 2:125, 3:125, 4:125, 6:NULL | 5 / 6 |
| Two more | 1:80, 2:125, 3:125, 4:125, 6:150, 7:NULL, 8:NULL | 7 / 8 |
В примере показаны все три формы EXTEND. Это добавление в конец внутренней структуры, а не заполнение пропусков. Для восстановления удалённого элемента 5 можно было бы присвоить значение непосредственно v_fees(5).
Включите DBMS Output в клиенте; в SQL*Plus/SQLcl выполните SET SERVEROUTPUT ON. Вывод рассчитан по данным примеров.
Документация Oracle 19c: Collection Methods, Collection Method Invocation.