INSTR

📖 Описание

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


🧩 Синтаксис

INSTR(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.
  • См. также INSTRB и REGEXP_INSTR.

💻 Примеры

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

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

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

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

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

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

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

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

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