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.