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.