RegularExpressionNamedGroup()

Синтаксис

Result$ = RegularExpressionNamedGroup(#RegularExpression , GroupName$)

Описание

Извлекает строку, которая соответствует указанной именованной группе Регулярного выражения, после вызова функции NextRegularExpressionMatch().

Параметры

#RegularExpression	Номер идентифицирующий используемое Регулярное выражение. Для этого Регулярного выражения должны быть вызваны функции ExamineRegularExpression() и NextRegularExpressionMatch().
GroupName$	Имя используемой группы. Имя группы - чувствительно к регистру.

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

Возвращает строку, которая соответствует указанной именованной группе РВ.

Комментарии

Группы в Регулярном выражении определяются путем включения в него подвыражения в круглых скобках "(" и ")". Доступ к группам можно получить либо по индексу (как это делается с помощью функции RegularExpressionGroup()), либо используя присвоенное им имя, согласно такому синтаксису: "(?<name>)", как показано ниже в примере.

Пример

; Это выражение соответствует строке настройки цвета (со значением red, green или blue)
; Цвета сгруппированы скобками (), и группа получила имя "col".
; Имя подходящего цвета извлекается.
;
If CreateRegularExpression(0, "color=(?red|green|blue)")
    If ExamineRegularExpression(0, "stype=bold, color=blue, margin=50")
        While NextRegularExpressionMatch(0)
            Debug "The color is " + RegularExpressionNamedGroup(0, "col") ; Возвратит из текста строку "blue", она соответствует группе  "col".
        Wend
    EndIf
Else
    Debug RegularExpressionError()
EndIf

См. также

ExamineRegularExpression(), NextRegularExpressionMatch(), RegularExpressionNamedGroupPosition(), RegularExpressionNamedGroupLength(), RegularExpressionGroup()

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

Все