Глобальный контекст.СтрПодобнаПоРегулярномуВыражению

Методы · StrLikeByRegularExpression

Проверяет, соответствует ли передаваемая строка передаваемому шаблону исходного выражения.

Синтаксис

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

Примеры платформы

РегВыражение = "(\+)?([- ()]?\d[- _():=+]?){10,14}";
Строка = "+9(999)999 99-99";
Результат =
    СтрПодобнаПоРегулярномуВыражению(НомерТелефона, РегВыражение);
Полное описание, параметры и ограничения

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

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

СтрПодобнаПоРегулярномуВыражению (StrLikeByRegularExpression)

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

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

<Строка> (обязательный)
Тип: Строка.
Исходная строка.

<РегулярноеВыражение> (обязательный)
Тип: Строка.
Регулярное выражение, на соответствие которому проверяется исходная строка.

<ИгнорироватьРегистр> (необязательный)
Тип: Булево.
Истина - без учета регистра, Ложь - с учетом регистра.
Значение по умолчанию: Ложь.

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

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

Проверяет, соответствует ли передаваемая строка передаваемому шаблону исходного выражения.

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

Сервер, толстый клиент, внешнее соединение.

Пример:

РегВыражение = "(\+)?([- ()]?\d[- _():=+]?){10,14}";
Строка = "+9(999)999 99-99";
Результат =
СтрПодобнаПоРегулярномуВыражению(НомерТелефона, РегВыражение);

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

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

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

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

Практические примеры

Проверить календарную дату YYYY-MM-DD из учебного обмена

Проверяем форму строки и затем существование календарной даты. Три контрольных строки показывают два разных класса отказа.

Где и как запускать

В учебной базе создайте серверный общий модуль УчебныеЗадачи. Вставьте приведённые функции и процедуру целиком в модуль, не внутрь другой процедуры. Вызовите УчебныеЗадачи.ВыполнитьПример() из серверного обработчика команды учебной обработки. Каждый урок запускайте отдельно, без дублирования одноимённых процедур.

Подготовка

  1. Используется фиксированная дата, а не ТекущаяДата: результаты можно сравнить независимо от дня запуска.

  2. Данные создаются только в памяти учебной базы; рабочие документы и регистры не меняются.

  3. Урок поддерживает только календарную дату без времени и смещения. Это не универсальный разбор ISO 8601.


Функция УчебнаяДатаИзСтроки(Текст) Экспорт
    Если ТипЗнч(Текст) <> Тип("Строка") Тогда
        ВызватьИсключение "Дата должна быть строкой YYYY-MM-DD";
    КонецЕсли;
    Если СтрДлина(Текст) <> 10 Или Не СтрПодобнаПоРегулярномуВыражению(Текст, "^[0-9]{4}-[0-9]{2}-[0-9]{2}$") Тогда
        ВызватьИсключение "Неверный формат календарной даты";
    КонецЕсли;
    НомерГода = Число(Лев(Текст, 4));
    НомерМесяца = Число(Сред(Текст, 6, 2));
    НомерДня = Число(Прав(Текст, 2));
    Результат = Дата(НомерГода, НомерМесяца, НомерДня);
    Если Год(Результат) <> НомерГода Или Месяц(Результат) <> НомерМесяца Или День(Результат) <> НомерДня Тогда
        ВызватьИсключение "Дата не соответствует календарю";
    КонецЕсли;
    Возврат Результат;
КонецФункции

Процедура ВыполнитьПример() Экспорт
    Входящие = Новый Массив;
    Входящие.Добавить("2026-02-28");
    Входящие.Добавить("2026-02-30");
    Входящие.Добавить("28.02.2026");
    Для Каждого Текст Из Входящие Цикл
        Попытка
            ЗначениеДаты = УчебнаяДатаИзСтроки(Текст);
            Сообщить("Принято: " + Формат(ЗначениеДаты, "ДФ=yyyy-MM-dd"));
        Исключение
            Сообщить("Отклонено: " + Текст);
        КонецПопытки;
    КонецЦикла;
КонецПроцедуры

Разбор по шагам

  1. Проверяем тип, длину и расположение ASCII-цифр и дефисов до выделения частей.

  2. Извлекаем год, месяц и день в числовом виде.

  3. Дата создаёт календарное значение; дополнительно сверяем компоненты, чтобы не принять преобразованный другой день.

  4. В вызывающей процедуре ошибка одной строки не останавливает проверку остальных учебных входов.

Как проверить результат

  1. 2026-02-28 принято; 2026-02-30 и 28.02.2026 отклонены.

  2. Замените первую строку на 2024-02-29: она должна быть принята.

  3. Строка 2026-02-28T10:00:00Z отклоняется: такой формат не входит в учебный контракт.

Ожидаемый результат

Форма строки и календарная корректность проверены отдельными этапами.

На что обратить внимание

  1. Регулярное выражение проверяет структуру текста, но само не знает, сколько дней в феврале.

  2. Исходные строки здесь вымышленные; в рабочем журнале учитывайте требования к личным данным.

  3. Не подавляйте ошибку без статуса: вызывающий код должен отличать отказ от успешно разобранной даты.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Обработать учебный пакет и сохранить все отказы отдельно

Принимаем целые неотрицательные количества по строгому текстовому контракту. Ошибка одной записи не останавливает весь пакет и не становится количеством 0.

Где и как запускать

В учебной базе создайте серверный общий модуль УчебныеЗадачи. Вставьте приведённые функции и процедуру целиком в модуль, не внутрь другой процедуры. Вызовите УчебныеЗадачи.ВыполнитьПример() из серверного обработчика команды учебной обработки. Каждый урок запускайте отдельно, без дублирования одноимённых процедур.

Подготовка

  1. Ошибки намеренно создаются на вымышленных значениях в учебной базе; файлы и рабочие данные не используются.

  2. ИнформацияОбОшибке и ОписаниеОшибки вызываются внутри Исключение, а не вне обработчика.

  3. Данный учебный контракт запрещает дроби, знак, пробелы и ведущие нули. Это не универсальное правило количеств в конфигурациях 1С.

  4. Никакой записи в базе нет: успешные строки и отказы собираются в двух массивах.


Функция УчебноеКоличествоИзСтроки(Текст) Экспорт
    Если ТипЗнч(Текст) <> Тип("Строка") Тогда
        ВызватьИсключение "Количество должно быть строкой";
    КонецЕсли;
    Если СтрДлина(Текст) > 6 Или Не СтрПодобнаПоРегулярномуВыражению(Текст, "^(0|[1-9][0-9]{0,5})$") Тогда
        ВызватьИсключение "Ожидается целое количество от 0 до 999999 без знака и ведущих нулей";
    КонецЕсли;
    Возврат Число(Текст);
КонецФункции

Процедура ВыполнитьПример() Экспорт
    Входящие = Новый Массив;
    Входящие.Добавить("0");
    Входящие.Добавить("3");
    Входящие.Добавить("-1");
    Входящие.Добавить("1.5");
    Входящие.Добавить("abc");
    Входящие.Добавить("1234567");
    Принятые = Новый Массив;
    Отказы = Новый Массив;
    Номер = 0;
    Для Каждого Текст Из Входящие Цикл
        Номер = Номер + 1;
        Попытка
            Количество = УчебноеКоличествоИзСтроки(Текст);
            Принятые.Добавить(Новый Структура("Номер,Количество", Номер, Количество));
        Исключение
            Ошибка = ИнформацияОбОшибке();
            Отказы.Добавить(Новый Структура("Номер,Описание", Номер, КраткоеПредставлениеОшибки(Ошибка)));
        КонецПопытки;
    КонецЦикла;
    Для Каждого Запись Из Принятые Цикл
        Сообщить(СтрШаблон("Принято: строка %1, количество %2", Запись.Номер, Запись.Количество));
    КонецЦикла;
    Для Каждого Отказ Из Отказы Цикл
        Сообщить(СтрШаблон("Отклонено: строка %1, %2", Отказ.Номер, Отказ.Описание));
    КонецЦикла;
    Сообщить(СтрШаблон("Принято %1; отказов %2", Принятые.Количество(), Отказы.Количество()));
    Если Принятые.Количество() <> 2 Или Отказы.Количество() <> 4 Тогда
        ВызватьИсключение "Учебный пакет дал неожиданные итоги";
    КонецЕсли;
КонецПроцедуры

Разбор по шагам

  1. Функция проверяет вход и только затем преобразует допустимую строку в число.

  2. Внутри цикла отдельная Попытка относится к одной записи, поэтому остальные входы продолжают проверяться.

  3. Принятые записи сохраняют исходный номер строки и количество; отказы — номер и причину.

  4. Итоговый контроль доказывает полноту обработки шести входов, а не только отсутствие необработанного исключения.

Как проверить результат

  1. Приняты строки 1 и 2 с количествами 0 и 3; отклонены строки 3, 4, 5 и 6.

  2. Итоги: принято 2, отказов 4. Не должно быть шести принятых строк с нулём у ошибочных входов.

  3. Замените abc на 5: измените контрольные итоги на 3 и 3; новый вход должен стать успешным.

  4. Строка 03 отклоняется по согласованному правилу ведущих нулей, тогда как 0 допустима.

Ожидаемый результат

Каждый вход получил отдельный результат, и все отказы сохранены без остановки учебного пакета.

На что обратить внимание

  1. Схема продолжения после ошибки подходит не для каждой операции: взаимозависимые записи могут требовать атомарного отказа всего пакета.

  2. При реальной записи в базу отдельно проектируйте транзакции, повторные попытки и защиту от дублей.

  3. Общий перехват здесь безопасен для чистой учебной проверки. Системные сбои реального обмена не следует молча классифицировать как обычные ошибки входа.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.