Глобальный контекст.СтрНайтиПоРегулярномуВыражению (Global context.StrFindByRegularExpression)

Глобальный контекст (Global context)

СтрНайтиПоРегулярномуВыражению (StrFindByRegularExpression)

Доступен, начиная с версии 8.3.23.

Синтаксис:

СтрНайтиПоРегулярномуВыражению(<Строка>, <РегулярноеВыражение>, <НаправлениеПоиска>, <НачальнаяПозиция>, <НомерВхождения>, <ИгнорироватьРегистр>, <МногострочныйПоиск>)

Параметры:

<Строка> (обязательный)

Тип: Строка.
Исходная строка.

<РегулярноеВыражение> (обязательный)

Тип: Строка.
Регулярное выражение, по которому выполняется поиск.

<НаправлениеПоиска> (необязательный)

Тип: НаправлениеПоиска.
Указывает направление поиска регулярного выражения в строке.
Значение по умолчанию: СНачала.

<НачальнаяПозиция> (необязательный)

Тип: Число.
Указывает позицию в строке, с которой начинается поиск.

Если параметр не задан и в параметре НаправлениеПоиска указано значение СНачала, то значение по умолчанию равно 1.
Если параметр не задан и в параметре НаправлениеПоиска указано значение СКонца, то значение по умолчанию равно длине строки.

Допускаются значения от 1 до количества символов в строке, в которой выполняется поиск. Если указано значение, не входящее в диапазон, генерируется ошибка "Неверное значение параметра".
Значение по умолчанию: 1.

<НомерВхождения> (необязательный)

Тип: Число.
Указывает номер вхождения искомой подстроки в исходной строке.
Значение по умолчанию: 1.

<ИгнорироватьРегистр> (необязательный)

Тип: Булево.
Истина - без учета регистра, Ложь - с учетом регистра.
Значение по умолчанию: Ложь.

<МногострочныйПоиск> (необязательный)

Тип: Булево.
Истина - выполняется многострочный поиск: символу "^" в шаблоне регулярного выражения соответствует начало каждой строки значения параметра <Строка>, символу "$" - конец каждой строки.

Ложь - символу "^" в шаблоне регулярного выражения соответствует начало значения в параметре <Строка>, символу "$" - конец текста.
Значение по умолчанию: Ложь.

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

Тип: РезультатПоискаПоРегулярномуВыражению.

Описание:

Находит первое вхождение регулярного выражения в исходной строке.

Доступность:

Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер).

Пример:

Строка = "Roses are #ff0000";
РегулярноеВыражение = "#([a-f0-9]{6})";

РезультатПоиска = СтрНайтиПоРегулярномуВыражению(Строка, РегулярноеВыражение);
Если РезультатПоиска.НачальнаяПозиция <> 0 Тогда
СтрокаРезультат = СРед(Строка,
РезультатПоиска.НачальнаяПозиция, РезультатПоиска.Длина);
КонецЕсли;

Использование в версии:

Доступен, начиная с версии 8.3.23.

Описание изменено в версии 8.3.24.

Методическая информация