Находит первое вхождение регулярного выражения в исходной строке.
Синтаксис
Функция СтрНайтиПоРегулярномуВыражению() имеет следующий синтаксис:
РезультатПоиска СтрНайтиПоРегулярномуВыражению(ИсходнаяСтрока, РегулярноеВыражение, [НаправлениеПоиска], [НачальнаяПозиция], [НомерВхождения], [ИгнорироватьРегистр], [МногострочныйПоиск])
А также альтернативный англоязычный синтаксис:
SearchResult StrFindByRegularExpression(SourceString, RegEx, [Direction], [StartPos], [Count], [RegisterIgnore], [Multiline])
Параметры
Описание параметров функции СтрНайтиПоРегулярномуВыражению():
| Имя параметра* | Тип | Описание | ||||
|---|---|---|---|---|---|---|
| ИсходнаяСтрока | Строка | Исходная строка. | ||||
| РегулярноеВыражение | Строка | Регулярное выражение, по которому выполняется поиск. | ||||
| НаправлениеПоиска | НаправлениеПоиска | Указывает направление поиска регулярного выражения в строке. Возможные значения:
Значение по умолчанию: |
||||
| НачальнаяПозиция | Число | Указывает позицию в строке, с которой начинается поиск. Если параметр не задан и задано НаправлениеПоиска.СНачала, то значение по умолчанию равно 1. Если параметр не задан и задано НаправлениеПоиска.СКонца, то значение по умолчанию равно длине строки. |
||||
| НомерВхождения | Число | Указывает номер вхождения искомой подстроки в исходной строке. Значение по умолчанию: 1. |
||||
| ИгнорироватьРегистр | Булево | Признак поиска без учета регистра символов:Истина — без учета регистра,Ложь — с учетом регистра.Значение по умолчанию: Ложь. |
||||
| МногострочныйПоиск | Булево | Признак многострочного поиска:Истина — выполняется многострочный поиск: символу ^ в шаблоне регулярного выражения соответствует начало каждой строки значения параметра <ИсходнаяСтрока>, символу $ — конец каждой строки.Ложь — символу ^ в шаблоне регулярного выражения соответствует начало значения в параметре <ИсходнаяСтрока>, символу $ — конец текста. |
||||
| *Жирным шрифтом выделены обязательные параметры | ||||||
Возвращаемое значение
РезультатПоиска — объект типа РезультатПоискаПоРегулярномуВыражению.
Описание
Функция СтрНайтиПоРегулярномуВыражению() находит первое (очередное) вхождение регулярного выражения в исходной строке с указанной позиции. Для поиска всех вхождений используйте функцию СтрНайтиВсеПоРегулярномуВыражению().
Доступность
| Версия | Поддержка |
|---|---|
| 8.1 | не поддерживается! |
| 8.2 | не поддерживается! |
| 8.3.23+ | Сервер, Толстый клиент, Внешнее соединение, Мобильное приложение |
Пример использования
Пример кода с использованием функции СтрНайтиПоРегулярномуВыражению():
//допустим, у нас есть значение ИсходныйТекст = "32.5C"; //и нам нужно проверить, что это число РезПоиска = СтрНайтиПоРегулярномуВыражению(ИсходныйТекст, "^[0-9]+(\.[0-9]*)?$"); Если РезПоиска.НачальнаяПозиция > 0 Тогда //все в порядке Сообщить(Число(РезПоиска.Значение)); Иначе Сообщить("Ничего не нашлось!"); КонецЕсли;
Если принцип построения регулярного выражения в этом примере Вам не понятен, рекомендую ознакомиться с Приложением 2 «Регулярные выражения на встроенном языке»
Поделиться страницей в соц.сетях