PureBasic

RegularExpressionGroupLength()

Синтаксис

Result = RegularExpressionGroupLength(#RegularExpression , Group)

Описание


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

Параметры

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

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

Возвращает длину строки, соответствующей указанной группе Регулярного выражения.

Комментарии

Группы в Регулярном выражении определяются путем включения в него подвыражения в круглых скобках "(" и ")". Группы нумеруются, как они появляются в регулярном выражении - слева направо. Первая группа имеет индекс 1.
Функция CountRegularExpressionGroups() может использоваться для определения количества групп в регулярном выражении.

Как альтернатива для RegularExpressionGroupLength(), может использоваться функция RegularExpressionNamedGroupLength().

Пример

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

См. также

ExamineRegularExpression(), NextRegularExpressionMatch(), RegularExpressionGroup(), RegularExpressionGroupPosition(), RegularExpressionNamedGroupLength()

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

Все

<- RegularExpressionGroup() - Оглавление RegularExpression - RegularExpressionGroupPosition()->