0

Функция СтрНайти()

Возвращает первое или очередное вхождение подстроки в исходную строку.

Синтаксис

Функция СтрНайти() имеет следующий синтаксис:

Число СтрНайти(ИсходнаяСтрока, ПодстрокаПоиска, [НаправлениеПоиска], [НачальнаяПозиция], [НомерВхождения])

А также альтернативный англоязычный синтаксис:

number StrFind(SourceString, Substring, [Direction], [StartPos], [MatchNumber])

Параметры

Описание параметров функции СтрНайти():

Имя параметра Тип Описание
ИсходнаяСтрока  Строка Исходная строка.
ПодстрокаПоиска Строка Искомая подстрока.
НаправлениеПоиска (необязательный) НаправлениеПоиска Указывает направление поиска подстроки в строке. Возможные значения:

СКонца Задает направление поиска от конца строки к ее началу
СНачала Задает направление поиска от начала строки в концу

Значение по умолчанию: НаправлениеПоиска.СНачала

НачальнаяПозиция (необязательный) Число Указывает позицию в строке, с которой начинается поиск. Если параметр не задан и в параметре НаправлениеПоиска указано значение СНачала, то значение по умолчанию равно 1.
НомерВхождения (необязательный) Число Указывает порядковый номер вхождения подстроки в исходной строке. Значение по умолчанию: 1 (ищется первое вхождение)
Жирным шрифтом выделены обязательные параметры

Возвращаемое значение

Число
Позиция первого символа найденной подстроки.

Описание

Функция СтрНайти() находит требуемое вхождение подстроки поиска с начала или с конца исходной строки. Нумерация символов в строке начинается с 1. Если строка не содержит указанной подстроки, то возвращается 0. Если параметр ПодстрокаПоиска является пустой строкой, то возвращается 1. Если оба обязательных параметра являются пустыми строками, возвращается 1.

Внимание! Поиск выполняется с учетом регистра, аналогично устаревшей функции Найти().
Внимание!! В том случае, если Вы используете релиз платформы 1С:Предприятие ниже 8.3.6, функция работать не будет. При попытке сохранить модуль вы получите ошибку: «Функция СтрНайти() не определена!»

Доступность

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение(клиент), мобильное приложение(сервер), интеграция.

Пример использования

Пример кода с использованием функции СтрНайти():

ИсходнаяСтрока = "Заголовок: прочие товары"; 
Рез = СтрНайти(ИсходнаяСтрока, "заголовок:"); 
//Рез = 0, т.к. поиск регистрозависимый

//регистронезависимый поиск: 
Рез = СтрНайти(нрег(ИсходнаяСтрока), "заголовок:"); 
//Рез = 1

//поиск значений, расположенных в конце строк стал удобнее
ИсходнаяСтрока = "Значение: Стул комнатный Значение: 1";
Рез = СтрНайти(нрег(ИсходнаяСтрока), "значение:", НаправлениеПоиска.СКонца);

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *