Возвращает первое или очередное вхождение подстроки в исходную строку.
Синтаксис
Функция СтрНайти() имеет следующий синтаксис:
Число СтрНайти(ИсходнаяСтрока, ПодстрокаПоиска, [НаправлениеПоиска], [НачальнаяПозиция], [НомерВхождения])
А также альтернативный англоязычный синтаксис:
number StrFind(SourceString, Substring, [Direction], [StartPos], [MatchNumber])
Параметры
Описание параметров функции СтрНайти():
| Имя параметра* | Тип | Описание | ||||
|---|---|---|---|---|---|---|
| ИсходнаяСтрока | Строка | Исходная строка. | ||||
| ПодстрокаПоиска | Строка | Искомая подстрока. | ||||
| НаправлениеПоиска | НаправлениеПоиска | Указывает направление поиска подстроки в строке. Возможные значения:
Значение по умолчанию: |
||||
| НачальнаяПозиция | Число | Указывает позицию в строке, с которой начинается поиск. Если параметр не задан и задано направление НаправлениеПоиска.СНачала, то значение по умолчанию равно 1. |
||||
| НомерВхождения | Число | Указывает порядковый номер вхождения подстроки в исходной строке. Значение по умолчанию: 1 (ищется первое вхождение) | ||||
| *Жирным шрифтом выделены обязательные параметры | ||||||
Возвращаемое значение
Число — позиция первого символа найденной подстроки.
Описание
Функция СтрНайти() находит требуемое вхождение подстроки поиска с начала или с конца исходной строки. Нумерация символов в строке начинается с 1. Если строка не содержит указанной подстроки, то возвращается 0. Если параметр ПодстрокаПоиска является пустой строкой, то возвращается 1. Если оба обязательных параметра являются пустыми строками, возвращается 1.
Внимание! Поиск выполняется с учетом регистра, аналогично устаревшей функции
Найти().Доступность
| Версия | Поддержка |
|---|---|
| 8.1 | не поддерживается! |
| 8.2 | не поддерживается! |
| 8.3.6+ | Сервер, Толстый клиент, Тонкий клиент, Веб-клиент, Внешнее соединение, Мобильный автономный сервер, Мобильный клиент, Мобильное приложение |
Внимание!! В том случае, если Вы используете релиз платформы 1С:Предприятие 8.3.5 и ниже (либо аналогичный режим совместимости конфигурации), функция работать не будет. При попытке сохранить модуль вы получите ошибку: «Функция СтрНайти() не определена!»
Пример использования
Пример кода с использованием функции СтрНайти():
ИсходнаяСтрока = "Заголовок: прочие товары"; Рез = СтрНайти(ИсходнаяСтрока, "заголовок:"); //Рез = 0, т.к. поиск регистрозависимый //регистронезависимый поиск: Рез = СтрНайти(нрег(ИсходнаяСтрока), "заголовок:"); //Рез = 1 //поиск значений, расположенных в конце строк стал удобнее ИсходнаяСтрока = "Значение: Стул комнатный Значение: 1"; Рез = СтрНайти(нрег(ИсходнаяСтрока), "значение:", НаправлениеПоиска.СКонца);
Читайте также:
Ошибка «Функция СтрНайти() не определена»
Поделиться страницей в соц.сетях