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.