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.