RegularExpressionNamedGroup()

Syntax

Ergebnis$ = RegularExpressionNamedGroup(#RegularExpression, GruppenName$)

Extrahiert den mit einer benannten Gruppe innerhalb des regulären Ausdrucks übereinstimmenden String, nach einem Aufruf von NextRegularExpressionMatch().

Parameter

#RegularExpression	Der zu verwendende reguläre Ausdruck. ExamineRegularExpression() und NextRegularExpressionMatch() müssen auf diesen regulären Ausdruck aufgerufen worden sein.
GruppenName$	Der Name der zu extrahierenden Gruppe. Der Gruppenname beachtet die Groß- und Kleinschreibung.

Rückgabewert

Gibt den mit einer Gruppe des regulären Ausdrucks übereinstimmenden String zurück.

Anmerkungen

Gruppen in einem regulären Ausdruck werden definiert, indem ein Unter-Ausdruck ("sub-expression") von Klammern "(" und ")" umschlossen wird. Auf Gruppen kann sowohl mittels Index-basierender Funktionen wie RegularExpressionGroup() zugegriffen werden, als auch durch Zuweisung eines Namens mittels des "(?<name>)" Syntax wie im Beispiel unten zu sehen.

Beispiel

  ; Dieser Ausdruck stimmt mit einem Farbeinstellungs-String (mit den Werten Rot,
  ; Grün oder Blau) überein. Die Farben sind gruppiert mit (), was den Namen
  ; "col" zugewiesen bekommen hat. Dieser Farbname wird dann extrahiert.
  ;  
  If CreateRegularExpression(0, "color=(?<col>red|green|blue)")
    If ExamineRegularExpression(0, "stype=bold, color=blue, margin=50")
      While NextRegularExpressionMatch(0)
        Debug "The color is " + RegularExpressionNamedGroup(0, "col")
      Wend
    EndIf
  Else
    Debug RegularExpressionError()
  EndIf

Siehe auch

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

Unterstützte OS

Alle