TRIM

📖 Описание

Метод TRIM — процедура удаления одного или нескольких элементов с конца Varray или Nested Tables. Для ассоциативных массивов метод недоступен.


🧩 Синтаксис

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

collection_name.TRIM;
collection_name.TRIM (n);

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

collection_name — переменная Varray или Nested Tables.
TRIM удаляет одну позицию с конца коллекции.
TRIM(n) удаляет n позиций с конца. Количество определяется по внутреннему размеру, включая места, оставшиеся после DELETE.


📝 Примечание

  • Если удаляемых позиций больше внутреннего размера коллекции, возникает SUBSCRIPT_BEYOND_COUNT. В частности, TRIM без аргумента вызывает эту ошибку для пустой коллекции.
  • TRIM работает с внутренним размером коллекции. То есть, если DELETE удаляет элемент, но сохраняет его заполнитель, TRIM считает, что этот элемент существует. Поэтому TRIM может удалить удаленный элемент.
    PL/SQL не удерживает заполнители для обрезанных элементов. Поэтому обрезанные элементы не входят во внутренний размер коллекции, и, вы не сможете восстановить обрезанный элемент, присвоив ему действительное значение.
  • Не смешивайте TRIM и DELETE без учёта внутреннего размера. При работе со вложенной таблицей выберите понятную модель: удаление по индексам через DELETE либо стек с EXTEND/TRIM. Пример ниже специально показывает разницу этих операций.
  • Смотрите также методы коллекций: PRIOR и NEXT, LIMIT, COUNT, FIRST и LAST, EXISTS, EXTEND, DELETE.
  • Для NULL-коллекции метод вызывает COLLECTION_IS_NULL. Это отличается от инициализированной пустой коллекции.

💻 TRIM и удалённое место в Nested Table

Пять тарифов образуют плотную таблицу. TRIM удаляет пятый; DELETE(3) оставляет внутреннее место третьего. Последующий TRIM(2) убирает позиции 4 и 3, хотя третья уже не считается существующим элементом.

DECLARE
  TYPE fee_list IS TABLE OF NUMBER;
  v_fees fee_list := fee_list(45, 70, 95, 120, 150);
  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.TRIM;
  show_fees('Trim one');
  v_fees.DELETE(3);
  show_fees('Delete index 3');
  v_fees.TRIM(2);
  show_fees('Trim two positions');
END;
/
Этап Индексы и значения COUNT Внутренний размер
Initial 1:45, 2:70, 3:95, 4:120, 5:150 5 5
Trim one 1:45, 2:70, 3:95, 4:120 4 4
Delete index 3 1:45, 2:70, 4:120 3 4
Trim two positions 1:45, 2:70 2 2

Последний TRIM(2) уменьшил COUNT только на 1, потому что одна из двух позиций уже была удалена. После обрезки для повторного добавления третьей позиции нужен EXTEND; простого присваивания v_fees(3) недостаточно.

Включите DBMS Output в клиенте; в SQL*Plus/SQLcl выполните SET SERVEROUTPUT ON. Вывод рассчитан по данным примеров.

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