COUNT
📖 Описание
В Oracle PL/SQL метод COUNT - это функция, которая возвращает количество элементов в коллекции (игнорируя удаленные элементы, даже если DELETE хранит для них заполнители).
🧩 Синтаксис
Синтаксис метода коллекций COUNT в Oracle PL/SQL.
element_count := collection_name.COUNT;
⚙️ Параметры и аргументы
collection_name — переменная коллекции любого типа.element_count — числовая переменная для количества существующих элементов. COUNT — функция без аргументов.
📝 Примечание
- Смотрите также методы коллекций: PRIOR и NEXT, LIMIT, FIRST и LAST, EXISTS, EXTEND, TRIM, DELETE.
- У пустой инициализированной коллекции COUNT = 0. Элемент со значением NULL учитывается, удалённый элемент — нет.
- Не путайте метод коллекции COUNT с агрегатной SQL-функцией COUNT.
- Для NULL-коллекции метод вызывает COLLECTION_IS_NULL. Это отличается от инициализированной пустой коллекции.
💻 COUNT для VARRAY
VARRAY всегда плотный. У непустой коллекции COUNT совпадает с LAST; у пустой COUNT равен 0, LAST — NULL. Проверим добавление и удаление элементов, включая полное опустошение.
DECLARE
TYPE minute_array IS VARRAY(8) OF PLS_INTEGER;
v_minutes minute_array := minute_array(25, 40, 55);
PROCEDURE show_size IS
BEGIN
DBMS_OUTPUT.PUT_LINE('COUNT=' || v_minutes.COUNT ||
', LAST=' || NVL(TO_CHAR(v_minutes.LAST), 'NULL'));
END;
BEGIN
show_size;
v_minutes.EXTEND(2);
show_size;
v_minutes.TRIM(4);
show_size;
v_minutes.TRIM;
show_size;
END;
/
-- COUNT=3, LAST=3
-- COUNT=5, LAST=5
-- COUNT=1, LAST=1
-- COUNT=0, LAST=NULL
💻 COUNT для Nested Table
После удаления второго элемента COUNT становится меньше LAST. EXTEND добавляет элементы после внутреннего конца коллекции, а не заполняет удалённое место.
DECLARE
TYPE fee_list IS TABLE OF NUMBER;
v_fees fee_list := fee_list(45, 60, 75, 90, 120);
PROCEDURE show_size IS
BEGIN
DBMS_OUTPUT.PUT_LINE('COUNT=' || v_fees.COUNT || ', LAST=' || v_fees.LAST);
END;
BEGIN
show_size;
v_fees.DELETE(2);
show_size;
v_fees.EXTEND;
show_size;
FOR i IN 1 .. 7 LOOP
IF v_fees.EXISTS(i) THEN
DBMS_OUTPUT.PUT_LINE(i || ': ' || NVL(TO_CHAR(v_fees(i)), 'NULL'));
ELSE
DBMS_OUTPUT.PUT_LINE(i || ': absent');
END IF;
END LOOP;
END;
/
-- COUNT=5, LAST=5
-- COUNT=4, LAST=5
-- COUNT=5, LAST=6
-- 1: 45
-- 2: absent
-- 3: 75
-- 4: 90
-- 5: 120
-- 6: NULL
-- 7: absent
Элемент 6 учтён в COUNT, хотя его значение NULL. Удалённый элемент 2 не учтён. Для обхода всех существующих элементов разреженной коллекции используйте FIRST/NEXT.
Для просмотра строк включите DBMS Output в клиенте; в SQL*Plus/SQLcl выполните SET SERVEROUTPUT ON. Ожидаемый вывод рассчитан для указанных данных.
Документация Oracle 19c: Collection Methods, Collection Method Invocation.