EXISTS
📖 Описание
Метод EXISTS проверяет, существует ли элемент коллекции с заданным индексом. Он возвращает BOOLEAN: TRUE для существующего элемента и FALSE для отсутствующего. Проверка подходит для ассоциативных массивов, вложенных таблиц и Varray.
🧩 Синтаксис
Синтаксис метода коллекций EXISTS в Oracle PL/SQL.
element_exists := collection_name.EXISTS(n);
⚙️ Параметры и аргументы
collection_name — переменная коллекции.n — проверяемый индекс (ключ).element_exists — переменная BOOLEAN. Результат EXISTS также можно сразу использовать в условии IF.
📝 Примечание
- Если n выходит за допустимые пределы, EXISTS возвращает FALSE вместо вызова предопределенного исключения SUBSCRIPT_OUTSIDE_LIMIT.
- Для удаленного элемента EXISTS (n) возвращает FALSE, даже если DELETE сохранил для него место для элемента.
- Смотрите также методы коллекций: PRIOR и NEXT, LIMIT, COUNT, FIRST и LAST, EXTEND, TRIM, DELETE.
- EXISTS — единственный метод коллекции, который допускает обращение к NULL-коллекции: результат FALSE.
- Если элемент существует, но его значение равно NULL, EXISTS возвращает TRUE. Существование элемента и его значение — разные проверки.
- Метод коллекции EXISTS отличается от условия EXISTS в SQL с подзапросом.
💻 EXISTS для Nested Table
В списке второй элемент существует со значением NULL, третий удалён, пятый не создавался. Проверка EXISTS позволяет различить эти случаи до чтения значения.
DECLARE
TYPE fee_list IS TABLE OF NUMBER;
v_fees fee_list := fee_list(80, NULL, 125, 160);
BEGIN
v_fees.DELETE(3);
FOR i IN 1 .. 5 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;
/
-- 1: 80
-- 2: NULL
-- 3: absent
-- 4: 160
-- 5: absent
💻 EXISTS для неинициализированной коллекции
DECLARE
TYPE fee_list IS TABLE OF NUMBER;
v_fees fee_list;
BEGIN
IF v_fees.EXISTS(1) THEN
DBMS_OUTPUT.PUT_LINE('Present');
ELSE
DBMS_OUTPUT.PUT_LINE('Absent');
END IF;
END;
/
-- Absent
Само обращение EXISTS здесь допустимо. Вызов COUNT или FIRST у той же NULL-коллекции вызвал бы COLLECTION_IS_NULL. После конструктора fee_list() коллекция была бы инициализированной, но всё ещё пустой.
Включите DBMS Output в клиенте; в SQL*Plus/SQLcl выполните SET SERVEROUTPUT ON. Вывод рассчитан по данным примеров.
Документация Oracle 19c: Collection Methods, Collection Method Invocation.