match-Methode
Aktualisiert: November 2007
Führt einen Suchlauf für eine Zeichenfolge nach dem Muster eines regulären Ausdrucks aus und gibt ein Array mit den Ergebnissen dieser Suche zurück.
function match(rgExp : RegExp) : Array
Argumente
- rgExp
Erforderlich. Eine Instanz eines Regular Expression-Objekts, die das Muster des regulären Ausdrucks sowie anwendbare Flags enthält. Es kann außerdem ein Variablenname oder Zeichenfolgenliteral sein, der bzw. das das Muster des regulären Ausdrucks sowie verfügbare Flags enthält.
Hinweise
Wenn die match-Methode keine Übereinstimmung findet, gibt sie den Wert null zurück. Wenn sie eine Übereinstimmung findet, gibt match ein Array zurück, und die Eigenschaften des globalen RegExp-Objekts werden aktualisiert, um die Ergebnisse der Übereinstimmung anzuzeigen.
Das von der match-Methode zurückgegebene Array hat drei Eigenschaften: input, index und lastIndex. Die input-Eigenschaft enthält die gesamte durchsuchte Zeichenfolge. Die index-Eigenschaft enthält die Position der übereinstimmenden untergeordneten Zeichenfolge in der gesamten durchsuchten Zeichenfolge. Die lastIndex-Eigenschaft enthält die Position, die auf das letzte Zeichen in der letzten Übereinstimmung folgt.
Wenn das globale Flag (g) nicht festgelegt ist, enthält das Element Null des Arrays die vollständige Übereinstimmung, wobei die Elemente 1 – n alle Teilübereinstimungen enthalten, die innerhalb der Übereinstimmung aufgetreten sind. Dieses Verhalten ist mit dem Verhalten der exec-Methode ohne festgelegtes globales Flag identisch. Wenn das globale Flag festgelegt ist, enthalten die Elemente 0 - n alle aufgetretenen Übereinstimmungen.
Beispiel
Das folgende Beispiel veranschaulicht die Verwendung der match-Methode.
function MatchDemo(){
var r, re; //Declare variables.
var s = "The rain in Spain falls mainly in the plain";
re = /ain/i; //Create regular expression pattern.
r = s.match(re); //Attempt match on search string.
return(r); //Return first occurrence of "ain".
}
Das folgende Beispiel veranschaulicht die Verwendung der match-Methode mit festgelegtem g-Flag.
function MatchDemo(){
var r, re; //Declare variables.
var s = "The rain in Spain falls mainly in the plain";
re = /ain/ig; //Create regular expression pattern.
r = s.match(re); //Attempt match on search string.
return(r); //Return array containing all four
// occurrences of "ain".
}
Die folgenden Codezeilen veranschaulichen die Verwendung eines Zeichenfolgenliterals mit der match-Methode.
var r, re = "Spain";
r = "The rain in Spain".replace(re, "Canada");