INSTR2

📖 Описание

Функция Oracle/PLSQL INSTR2 возвращает позицию указанного вхождения подстроки. Позиции и начало поиска измеряются в 16-битных единицах по семантике UCS-2.


🧩 Синтаксис

INSTR2(string, substring [, start_position [, nth_appearance]])

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

string — строка для поиска: CHAR, VARCHAR2, NCHAR или NVARCHAR2; CLOB и NCLOB не допускаются.

substring — искомая подстрока. В общем синтаксисе семейства допускаются CHAR, VARCHAR2, NCHAR, NVARCHAR2, CLOB и NCLOB; ограничения обработки LOB зависят от выбранной функции.

start_position — ненулевое целое число, по умолчанию 1. При отрицательном значении начальная позиция отсчитывается от конца строки, а поиск идёт к её началу.

nth_appearance — положительный целый номер вхождения, по умолчанию 1.

Примечания

  • Результат имеет тип NUMBER. Найденная позиция всегда отсчитывается от начала строки с 1, даже при обратном поиске.
  • Если нужного вхождения нет, возвращается 0; для NULL возвращается NULL.
  • См. также INSTR4 и REGEXP_INSTR.

💻 Примеры

В примерах используется обычное бинарное сравнение.

SELECT INSTR2('Лампа склада', 'а') FROM dual;
-- Результат: 2

SELECT INSTR2('Лампа склада', 'а', 1, 1) FROM dual;
-- Результат: 2

SELECT INSTR2('Лампа склада', 'а', 1, 2) FROM dual;
-- Результат: 5

SELECT INSTR2('Лампа склада', 'а', 1, 3) FROM dual;
-- Результат: 10

SELECT INSTR2('Лампа склада', 'а', -3, 2) FROM dual;
-- Результат: 5

SELECT INSTR2('Лампа склада', 'я') FROM dual;
-- Результат: 0

Обратный поиск начинается с позиции 10; второе найденное вхождение находится на позиции 5.

Дополнительный символ Unicode

SELECT INSTR2(UNISTR('A\D83D\DE80B'), 'B') FROM dual;
-- Результат: 4

Перед B стоят A и символ ракеты. Ракета занимает две 16-битные единицы, поэтому B находится на позиции 4.

См. документацию Oracle: INSTR2.

Семантика Unicode: Oracle Globalization Support Guide.