RegularExpressionGroup()

Syntax

Ergebnis$ = RegularExpressionGroup(#RegularExpression, Gruppe)
Beschreibung
Extrahiert den mit einer 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.
Gruppe Der Index der zu extrahierenden Gruppe. Die erste Gruppe hat den Index 1.

Rückgabewert

Gibt den String zurück, der mit einer Gruppe des regulären Ausdrucks übereinstimmt.

Anmerkungen

Gruppen in einem regulären Ausdruck werden definiert, indem ein Unter-Ausdruck ("sub-expression") von Klammern "(" und ")" umschlossen wird. Die Gruppen werden so nummeriert, wie sie im regulären Ausdruck vorkommen, von links nach rechts. Die erste Gruppe hat den Index 1.
Die CountRegularExpressionGroups() Funktion kann verwendet werden, um die Anzahl an Gruppen in einem regulären Ausdruck herauszufinden.

Als eine Alternative kann auch die RegularExpressionNamedGroup() Funktion verwendet werden.

Beispiel

  ; Dieser Ausdruck stimmt mit einem Farbeinstellungs-String (mit den Werten Rot,
  ; Grün oder Blau) überein. Die Farben sind mit () gruppiert und der Farbwert
  ; wird im Falle einer Übereinstimmung extrahiert.
  ;  
  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)
      Wend
    EndIf
  Else
    Debug RegularExpressionError()
  EndIf

Siehe auch

ExamineRegularExpression(), NextRegularExpressionMatch(), RegularExpressionGroupPosition(), RegularExpressionGroupLength(), RegularExpressionNamedGroup()

Unterstützte OS

Alle

<- RegularExpressionError() - RegularExpression Inhaltsverzeichnis - RegularExpressionGroupLength() ->