TearStrRE

TearStrRE (Функции для работы с регулярными выражениями)
Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Исключения: Невозможно превратить в строку, число, синтаксическая ошибка в шаблоне Визуальность: Нет

• Начальная страница
• Общее описание
• Строковые функции

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

Синтаксис

TearStrRE(<Строка, в которой происходит поиск (STRING)>,<Выражение (STRING)>,<Максимальное количество результатов для деления (INT)>=0,<Флаги поиска (INT)>=0):<Список результатов деления (LIST)>

Аргументы

• <Строка, в которой происходит поиск (STRING)> - Текст поиска.
• <Выражение (STRING)> - Шаблон регулярного выражения для поиска в тексте.
• <Максимальное количество результатов для деления (INT)> - (необязательный аргумент) Аргумент задает максимальное количество возможных результатов. В результирующем списке будет присутствовать количество фрагментов текста на один большее, чем найденное количество результатов. По умолчанию, 0 -- использовать все найденные результаты.
• <Флаги поиска (INT)> - (необязательный аргумент) Число - битовая маска режимов поиска по умолчанию. Имеет следующие биты:
  • бит 0: Использовать регистро-независимый поиск (1), по умолчанию поиск будет регистро-зависимым. Важно: данный режим изменяет только сравнение обычного текста, сравнение наборов символов ([...]) изменено не будет.
  • бит 1: Не использовать конструкции проверки позиции $ и ^, для нахождения начала и конца строки внутри текста, а только для нахождения начала и конца всего текста. По-умолчанию режим отключен.

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

Функция возвращает список, состоящий из строк. Если ни одно значение не найдено, список будет содержать одно значение -- исходную строку поиска.

Примеры

Стр:="The pink cockatoo is a medium-sized cockatoo that inhabits arid and semi-arid inland areas across Australia.";

Сп:=TearStrRE(Стр,"the|that",,1);
//Бужет получен список с тремя элементами:
//""
//" pink cockatoo is a medium-sized cockatoo "
//" inhabits arid and semi-arid inland areas across Australia."