INSTRC

📖 Описание

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


🧩 Синтаксис

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

💻 Примеры

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

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

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

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

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

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

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

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

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

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

Перед B стоят A и символ ракеты. Дополнительный символ учитывается как один, поэтому B находится на позиции 3.

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

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