FIRST и LAST

📖 Описание

В Oracle PL/SQL методы FIRST и LAST - это функции. Если в коллекции есть хотя бы один элемент, FIRST и LAST возвращают индексы первого и последнего элементов соответственно (игнорируя удаленные элементы, даже если DELETE хранит для них заполнители). Если коллекция имеет только один элемент, FIRST и LAST возвращают один и тот же индекс. Если коллекция пуста, FIRST и LAST возвращают NULL.


🧩 Синтаксис

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

first_index := collection_name.FIRST;
last_index := collection_name.LAST;

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

collection_name — переменная коллекции.
first_index и last_index — переменные для первого и последнего существующих индексов. Для массива со строковыми ключами используйте строковые переменные, для числовых индексов — целочисленные.


📝 Примечание

  • Смотрите также методы коллекций: PRIOR и NEXT, LIMIT, COUNT, EXISTS, EXTEND, TRIM, DELETE.
  • Первый и последний индексы не обязательно равны 1 и COUNT. Для разреженной коллекции между ними могут быть пропуски.
  • Для строковых ключей порядок зависит от NLS_SORT и NLS_COMP, а не от последовательности добавления элементов.
  • Для NULL-коллекции метод вызывает COLLECTION_IS_NULL. Это отличается от инициализированной пустой коллекции.

💻 Ассоциативный массив: числовые ключи

Ключи могут быть отрицательными и разреженными. FIRST и LAST возвращают крайние ключи, а не минимальное и максимальное значение элементов.

DECLARE
  TYPE capacity_map IS TABLE OF PLS_INTEGER INDEX BY PLS_INTEGER;
  v_capacity capacity_map;
  PROCEDURE show_bounds IS
  BEGIN
    DBMS_OUTPUT.PUT_LINE('FIRST=' || NVL(TO_CHAR(v_capacity.FIRST), 'NULL') ||
      ', LAST=' || NVL(TO_CHAR(v_capacity.LAST), 'NULL'));
  END;
BEGIN
  v_capacity(-5) := 12;
  v_capacity(10) := 8;
  v_capacity(30) := 20;
  v_capacity(90) := 6;
  show_bounds;
  v_capacity.DELETE(-5);
  v_capacity.DELETE(90);
  show_bounds;
  v_capacity.DELETE;
  show_bounds;
END;
/
-- FIRST=-5, LAST=90
-- FIRST=10, LAST=30
-- FIRST=NULL, LAST=NULL

💻 Ассоциативный массив: строковые ключи

Показанный вывод соответствует бинарному порядку ключей CLAY, GLASS, PAPER, WOOD. Порядок зависит от NLS_SORT/NLS_COMP; не меняйте эти параметры после заполнения массива.

DECLARE
  TYPE capacity_map IS TABLE OF PLS_INTEGER INDEX BY VARCHAR2(12);
  v_capacity capacity_map;
BEGIN
  v_capacity('WOOD') := 6;
  v_capacity('PAPER') := 12;
  v_capacity('CLAY') := 8;
  v_capacity('GLASS') := 4;
  DBMS_OUTPUT.PUT_LINE(v_capacity.FIRST || ' / ' || v_capacity.LAST);
  v_capacity.DELETE('CLAY');
  v_capacity.DELETE('WOOD');
  DBMS_OUTPUT.PUT_LINE(v_capacity.FIRST || ' / ' || v_capacity.LAST);
END;
/
-- CLAY / WOOD
-- GLASS / PAPER

💻 VARRAY: FIRST, LAST и COUNT

У непустого VARRAY FIRST равен 1, LAST совпадает с COUNT. У пустого FIRST и LAST равны NULL.

DECLARE
  TYPE minute_array IS VARRAY(7) OF PLS_INTEGER;
  v_minutes minute_array := minute_array(30, 45);
  PROCEDURE show_bounds IS
  BEGIN
    DBMS_OUTPUT.PUT_LINE('FIRST=' || NVL(TO_CHAR(v_minutes.FIRST), 'NULL') ||
      ', LAST=' || NVL(TO_CHAR(v_minutes.LAST), 'NULL') || ', COUNT=' || v_minutes.COUNT);
  END;
BEGIN
  show_bounds;
  v_minutes.EXTEND(3);
  show_bounds;
  v_minutes.TRIM(4);
  show_bounds;
  v_minutes.TRIM;
  show_bounds;
END;
/
-- FIRST=1, LAST=2, COUNT=2
-- FIRST=1, LAST=5, COUNT=5
-- FIRST=1, LAST=1, COUNT=1
-- FIRST=NULL, LAST=NULL, COUNT=0

💻 VARRAY: проверка NULL и пустого списка перед обходом

DECLARE
  TYPE mentor_array IS VARRAY(3) OF VARCHAR2(20);
  v_mentors mentor_array;
  PROCEDURE show_mentors(p_label VARCHAR2) IS
  BEGIN
    DBMS_OUTPUT.PUT_LINE(p_label);
    IF v_mentors IS NULL THEN
      DBMS_OUTPUT.PUT_LINE('Not initialized');
    ELSIF v_mentors.FIRST IS NULL THEN
      DBMS_OUTPUT.PUT_LINE('Empty');
    ELSE
      FOR i IN v_mentors.FIRST .. v_mentors.LAST LOOP
        DBMS_OUTPUT.PUT_LINE(i || ': ' || v_mentors(i));
      END LOOP;
    END IF;
  END;
BEGIN
  show_mentors('Draft');
  v_mentors := mentor_array();
  show_mentors('Waiting');
  v_mentors := mentor_array('Aziza', 'Timur');
  show_mentors('Spring 2026');
  v_mentors := mentor_array('Nodira', 'Jasur', 'Malika');
  show_mentors('Autumn 2026');
END;
/
-- Draft
-- Not initialized
-- Waiting
-- Empty
-- Spring 2026
-- 1: Aziza
-- 2: Timur
-- Autumn 2026
-- 1: Nodira
-- 2: Jasur
-- 3: Malika

💻 Nested Table: пропуски между FIRST и LAST

Вложенная таблица может быть разреженной. До обращения по индексу проверяем EXISTS; диапазон FIRST .. LAST показывает и свободные места.

DECLARE
  TYPE station_list IS TABLE OF VARCHAR2(20);
  v_stations station_list;
  PROCEDURE show_stations IS
  BEGIN
    IF v_stations IS NULL THEN
      DBMS_OUTPUT.PUT_LINE('Not initialized');
    ELSIF v_stations.FIRST IS NULL THEN
      DBMS_OUTPUT.PUT_LINE('Empty');
    ELSE
      FOR i IN v_stations.FIRST .. v_stations.LAST LOOP
        IF v_stations.EXISTS(i) THEN
          DBMS_OUTPUT.PUT_LINE(i || ': ' || v_stations(i));
        ELSE
          DBMS_OUTPUT.PUT_LINE(i || ': free');
        END IF;
      END LOOP;
    END IF;
  END;
BEGIN
  show_stations;
  v_stations := station_list();
  show_stations;
  v_stations := station_list('Clay', 'Paper', 'Glass', 'Wood', 'Textile');
  show_stations;
  v_stations.DELETE(2, 4);
  show_stations;
END;
/
-- Not initialized
-- Empty
-- 1: Clay
-- 2: Paper
-- 3: Glass
-- 4: Wood
-- 5: Textile
-- 1: Clay
-- 2: free
-- 3: free
-- 4: free
-- 5: Textile

После удаления FIRST = 1, LAST = 5, COUNT = 2. Для вывода только существующих мест удобнее FIRST/NEXT.

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

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