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.