Regular Expression-Objekt

Artikel
08/10/2011

Ein Objekt, das ein Muster des regulären Ausdrucks sowie Flags enthält, die kennzeichnen, wie das Muster angewendet werden soll.

// The explicit constructor for a Regular Expression object.
function RegExp(pattern : String [,flags : String])
function RegExp(regexObj : System.Text.RegularExpressions.Regex)

// The implicit constructor for a Regular Expression object.
/pattern/[flags]

Argumente

-Muster
Erforderlich. Das zu verwendende Muster eines regulären Ausdrucks. Beim Verwenden von Syntax 1 muss das Muster eine Zeichenfolge sein. Beim Verwenden von Syntax 2 wird das Muster mit den Zeichen "/" begrenzt.
flags
Optional. Beim Verwenden von Syntax 1 müssen sich die Flags in einer Zeichenfolge befinden. Beim Verwenden von Syntax 2 folgen die Flagzeichen direkt im Anschluss an das letzte "/"-Zeichen. Folgende verfügbare Flags können kombiniert werden:
- g (globale Suche nach allen Vorkommen von pattern)
- i (Groß-/Kleinschreibung ignorieren)
- m (mehrzeilige Suche)
regexObj
Erforderlich. Ein Regex-Objekt, das das zu verwendende Muster eines regulären Ausdrucks enthält.

Hinweise

Das Regular Expression-Objekt darf nicht mit dem globalen RegExp-Objekt verwechselt werden. Obwohl ihre Namen sehr ähnlich klingen, sind sie leicht voneinander zu unterscheiden. Die Eigenschaften des Regular Expresssion-Objekts enthalten Informationen über eine einzige Regular Expresssion-Instanz, während die Eigenschaften des globalen RegExp-Objekts ständig aktualisierte Informationen über jede aufgetretene Übereinstimmung enthalten.

Regular Expression-Objekte speichern Muster, die für das Durchsuchen von Zeichenfolgen nach Zeichenkombinationen verwendet werden. Nach dem Erstellen des Regular Expression-Objekts wird dieses entweder an eine string-Methode übergeben, oder eine Zeichenfolge wird an eine Methode des Regular Expression-Objekts übergeben. Informationen über die zuletzt durchgeführte Suche werden im globalen RegExp-Objekt gespeichert.

Verwenden Sie Syntax 1, wenn sich die Suchzeichenfolge häufig ändert oder unbekannt ist, z. B. für Zeichenfolgen, die von einer Benutzereingabe abgeleitet werden. Verwenden Sie Syntax 2, wenn Ihnen die zu suchende Zeichenfolge vorher bekannt ist.

Das pattern-Argument wird bei JScript vor der Verwendung in ein internes Format kompiliert. Bei Syntax 1 wird pattern kurz vor der Verwendung bzw. beim Aufrufen der compile-Methode kompiliert. Bei Syntax 2 wird pattern beim Laden des Skripts kompiliert.

Tipp

Das Regular Expression-Objekt interagiert innerhalb von JScript mit dem System.Text.RegularExpressions.Regex-Datentyp von .NET Framework. Andere CLS (Common Language Specification-)Sprachen können das Regular Expression-Objekt jedoch nicht verwenden, da das Objekt nur von JScript bereitgestellt wird. Es wird nicht von einem .NET Framework-Typ abgeleitet. Achten Sie daher beim Ausstatten der Parameter und Rückgabetypen von CLS‑kompatiblen Methoden mit Typanmerkungen darauf, dass Sie den System.Text.RegularExpressions.Regex-Datentyp verwenden und nicht das Regular Expression-Objekt. Sie können das Regular Expression-Objekt jedoch verwenden, um andere Bezeichner als die Parameter oder Rückgabetypen mit Typanmerkungen auszustatten. Weitere Informationen hierzu finden Sie unter Schreiben von CLS-kompatiblem Code.

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung des Regular Expression-Objekts. Das re1-Objekt und das re2-Objekt werden erstellt. Die Objekte enthalten Muster regulärer Ausdrücke mit den zugewiesenen Flags. In diesem Fall werden die resultierenden Regular Expression-Objekte anschließend von der match-Methode verwendet:

var s : String = "The quick brown fox jumps over the lazy dog";
// Create regular expression object by using Syntax 1.
var re1 : RegExp = new RegExp("quick","i");
// Create regular expression object by using Syntax 2.
var re2 : RegExp = /THE/i;

// Find a match within string s.
print(s.match(re1));
print(s.match(re2));

Ausgabe dieses Skripts: