Admin: 1 revision imported

2024-09-06T11:05:39Z

1 revision imported

1>Admin at 12:33, 20 August 2024

2024-08-20T12:33:33Z

Admin: 1 revision imported

2023-12-30T13:55:23Z

1 revision imported

1>Admin at 13:43, 30 December 2023

2023-12-30T13:43:01Z

New page

{{infobox function
|name=MatchRE, PosRE
|caption=Функции для работы с регулярными выражениями
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число, синтаксическая ошибка в шаблоне, неверный режим
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Строковые функции]]}}
Производит проверку шаблона регулярных выражений, заданного первым аргументом в тексте, заданным вторым аргументом. В зависимости от режима поиска может возвратить найденную позицию или ноль, список найденных значений (и значений групп поиска), либо таблицу позиций найденных значений (и значений групп поиска).

== Синтаксис ==
<code>
'''MatchRE'''(''<Выражение (STRING)>'',''<Строка, в которой происходит поиск (STRING)>''{{Optional|,''<Позиция начала поиска (INT)>''{{Default|{{Eq}}0}}}}{{OptionalByRef|,<Длина найденного (INT)>)}}{{Optional|,<Режим поиска (INT)>{{Default|{{Eq}}0}},<Флаги поиска (INT)>{{Default|{{Eq}}0}}}}):''<Позиция, список или таблица (INT,LIST,TAB)>''
</code>
==== Аргументы ====
* <code>''<Выражение (STRING)>''</code> - Шаблон регулярного выражения для поиска.
* <code>''<Строка, в которой происходит поиск (STRING)>''</code> - Текст поиска.
* <code>''<Позиция начала поиска (INT)>''</code> - {{Optional}} Позиция начала поиска (по умолчанию -- с начала текста).
* <code>''<Длина найденного (INT)>''</code> - {{Optional}} {{ByRef}} Переменная, получающая длину найденного значения (только для режима поиска ''0'').
* <code>''<Режим поиска (INT)>''</code> - {{Optional}} Задает режим поиска и тип возвращаемых результатов. Возможны следующие значения:
** '''0''' (по умолчанию): Поиск останавливается на первом найденном результате, функция возвращает его позицию в исходном тексте и его длину в переменной, заданной четвертым аргументом. Если результат не найден, функция возвращает ноль.
** '''1''': Функция возвращает список, каждое значение которого является одним из найденных результатов.
** '''2''': Функция возвращает таблицу со столбцами "Index" и "Length". В таблицу заносятся все позиции и длины найденных результатов.
** '''3''': Функция возвращает список, каждое значение которого является одним из найденных результатов либо значением группы, имеющей индекс и результат (см. краткое описание в [[Строковые функции#Функции для работы с регулярными выражениями (regular expressions, RegExp)|строковых функциях]], а также описания стандартов регулярных выражений). Наименования списка будут пустыми для результатов, тогда как для значений групп содержать имя группы или номер группы (для групп без имен).
** '''4''': Функция возвращает таблицу со столбцами "Index", "Length" и "GroupID", в которую занесены все позиции и длины найденных результатов и значенией групп, имеющих индекс и результат (см. краткое описание в [[Строковые функции#Функции для работы с регулярными выражениями (regular expressions, RegExp)|строковых функциях]], а также описания стандартов регулярных выражений). Столбец "GroupID" будет пустым для результатов, тогда как для значений групп содержать имя группы или номер группы (для групп без имен).
* <code>''<Флаги поиска (INT)>''</code> - {{Optional}} Число - битовая маска режимов поиска по умолчанию. Имеет следующие биты:
** '''бит 0''': Использовать регистро-независимый поиск (''1''), по умолчанию поиск будет регистро-зависимым. '''Важно:''' данный режим изменяет только сравнение обычного текста, сравнение наборов символов ('''[...]''') изменено не будет.
** '''бит 1''': Не использовать конструкции проверки позиции '''$''' и '''^''', для нахождения начала и конца строки внутри текста, а только для нахождения начала и конца всего текста. По-умолчанию режим отключен.

==== Возвращаемое значение ====
Функция возвращает число, список или таблицу в зависимости от режима.

== Примеры ==
<pre>
Стр:="This image has a resolution of 1440×900 pixels.";
аТб:=MatchRE("([0-9]+)×([0-9]+)",Стр,,,4);

iMatch:=0;
аТб.Select();
While аТб.Next() Do
iMatch:=iMatch+IsEmpty(аТб.GroupID);
Message(""+?(IsEmpty(аТб.GroupID),"Совпадение "+iMatch+": "," Группа "+аТб.GroupID+": ")+?(аТб.Length=0,"(пустая строка с "+аТб.Index,Mid(Стр,аТб.Index,аТб.Length)+" (с "+аТб.Index+" по "+(аТб.Index+аТб.Length-1))+")");
EndDo;

//Будет выведено:
//Совпадение 1: 1440×900 (с 32 по 39)
// Группа 1: 1440 (с 32 по 35)
// Группа 2: 900 (с 37 по 39)
</pre>

← Older revision	Revision as of 11:05, 6 September 2024
(No difference)

@@ Line 15: / Line 15: @@
 == Синтаксис ==
 <code>
-'''MatchRE'''(''<Выражение (STRING)>'',''<Строка, в которой происходит поиск (STRING)>''{{Optional|,''<Позиция начала поиска (INT)>''{{Default|{{Eq}}0}}}}{{OptionalByRef|,<Длина найденного (INT)>)}}{{Optional|,<Режим поиска (INT)>{{Default|{{Eq}}0}},<Флаги поиска (INT)>{{Default|{{Eq}}0}}}}):''<Позиция, список или таблица (INT,LIST,TAB)>''
+'''MatchRE'''(''<Выражение (STRING)>'',''<Строка, в которой происходит поиск (STRING)>''{{Optional|,''<Позиция начала поиска (INT)>''{{Default|{{Eq}}0}}}}{{OptionalByRef|,<Длина найденного (INT)>}}{{Optional|,<Режим поиска (INT)>{{Default|{{Eq}}0}},<Флаги поиска (INT)>{{Default|{{Eq}}0}}}}):''<Позиция, список или таблица (INT,LIST,TAB)>''
 </code>
 ==== Аргументы ====

← Older revision	Revision as of 13:55, 30 December 2023
(No difference)

MatchRE - Revision history

Admin: 1 revision imported

1>Admin at 12:33, 20 August 2024

Admin: 1 revision imported

1>Admin at 13:43, 30 December 2023