ExamineRegularExpression()

Syntax

Ergebnis = ExamineRegularExpression(#RegularExpression, String$)

Startet das Überprüfen ("matching") des regulären Ausdrucks gegenüber dem angegebenen String. Einzelne Übereinstimmungen ("matches") können mit der NextRegularExpressionMatch() Funktion durchlaufen werden.
Von jeder Übereinstimmung können der passende String, seine Position/Länge und alle Gruppen innerhalb der Übereinstimmung mit der entsprechenden Funktion extrahiert werden.

Parameter

#RegularExpression	Der zu verwendende reguläre Ausdruck.
String$	Der String, auf den der reguläre Ausdruck angewandt werden soll.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn das Überprüfen erfolgreich gestartet wurde. Ob eine aktuelle Übereinstimmung gefunden wurde, kann durch Aufruf von NextRegularExpressionMatch() ermittelt werden.

Beispiel

  ; Dieser Ausdruck wird bei jedem Wort übereinstimmen, das 3 Zeichen beinhaltet,
  ; mit einem Kleinbuchstaben beginnt, gefolgt vom Buchstaben 'b' und mit einem
  ; Großbuchstaben endet. Zum Beispiel: abC
  ; Jede Übereinstimmung wird mit ihrer Position im Original-String ausgegeben.
  ;    
  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

Siehe auch

NextRegularExpressionMatch(), RegularExpressionMatchString(), RegularExpressionMatchPosition(), RegularExpressionMatchLength()

Unterstützte OS

Alle