ExamineRegularExpression()

Синтаксис

Result = ExamineRegularExpression(#RegularExpression , String$)

Описание

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

Параметры

#RegularExpression	Номер идентифицирующий используемое Регулярное выражение.
String$	Исходный текст, для которого применяется Регулярное выражение.

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

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

Пример

; Этому выражению соответствует каждое слово из 3 символов, которое начинается с символа в нижнем регистре,
; за ним следует символ 'b' и заканчивается символом в верхнем регистре. напр.: abC
; Каждое совпадение печатается с его позицией в исходной строке.
;
If CreateRegularExpression(0, "[a-z]b[A-Z]")
    If ExamineRegularExpression(0, "abC ABc zbA abc")
        While NextRegularExpressionMatch(0)
            Debug "Match: " + RegularExpressionMatchString(0)
            Debug "Position: " + Str(RegularExpressionMatchPosition(0))
            Debug "Length: " + Str(RegularExpressionMatchLength(0))
        Wend
    EndIf
Else
    Debug RegularExpressionError()
EndIf

См. также

NextRegularExpressionMatch(), RegularExpressionMatchString(), RegularExpressionMatchPosition(), RegularExpressionMatchLength()

Поддерживаемые OS

Все