INSTRB

📖 Описание

Функция Oracle/PLSQL INSTRB возвращает позицию указанного вхождения подстроки. Позиции и начало поиска измеряются в байтах.


🧩 Синтаксис

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

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

string — строка для поиска: CHAR, VARCHAR2, NCHAR или NVARCHAR2. Для CLOB поддерживается только однобайтовая кодировка.

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

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

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

Примечания

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

💻 Примеры

В примерах используется обычное бинарное сравнение и кодировка базы AL32UTF8: каждая русская буква занимает два байта, пробел — один.

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

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

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

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

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

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

Обратный поиск начинается с байта 18, то есть с третьей буквы «а»; второе найденное вхождение начинается с байта 9.

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

Ограничения LOB: SQL Semantics and LOBs.