NextRegularExpressionMatch()

Синтаксис

Result = NextRegularExpressionMatch(#RegularExpression)

Описание

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

Параметры

#RegularExpression

Номер идентифицирующий используемое Регулярное выражение. Предварительно необходимо вызвать ExamineRegularExpression().

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

Возвращает не нулевое значение, если была найдена следующая строка соответствующая РВ. Если в исходном тексте больше нет соответствий - возвращает 0.

Комментарии

Чтобы получить информацию о текущем соответствии используйте следующие функции:

- RegularExpressionMatchString(): Возвращает текущую строку соответствующую РВ.
- RegularExpressionMatchPosition(): Возвращает позицию текущей строки соответствующей РВ.
- RegularExpressionMatchLength(): Возвращает длину текущей строки соответствующей РВ.
- RegularExpressionGroup(): Извлекает строку соответствующую указанной группе РВ.
- RegularExpressionGroupPosition(): Возвращает позицию строки соотв. указанной группе (внутри строки соотв. РВ).
- RegularExpressionGroupLength(): Возвращает длину строки соотв. указанной группе.
- RegularExpressionNamedGroup(): Извлекает строку соответствующую именованной группе.
- RegularExpressionNamedGroupPosition(): Возвращает позицию строки соотв. именованной группе (внутри строки соотв. РВ).
- RegularExpressionNamedGroupLength(): Возвращает длину строки соотв. именованной группе.

Пример

; Этому выражению соответствует каждое слово из 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

См. также

ExamineRegularExpression()

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

Все