match-Methode
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 von exec-Methode identisch, wenn das globale Kennzeichen nicht auf die Methode festgelegt ist. Wenn das globale Flag festgelegt ist, enthalten die Elemente 0 - n alle aufgetretenen Übereinstimmungen.
Beispiel
Das folgende Beispiel veranschaulicht die Verwendung der match-Methode, wenn das globale Kennzeichen (g) nicht festgelegt ist.
var src = "Please send mail to george@contoso.com and someone@example.com. Thanks!";
// Create a regular expression to search for an e-mail address.
// The global flag is not included.
// (More sophisticated RegExp patterns are available for
// matching an e-mail address.)
var re = /(\w+)@(\w+)\.(\w+)/;
var result = src.match(re);
// Because the global flag is not included, the entire match is
// in array element 0, and the submatches are in elements 1 through n.
print(result[0]);
for (var index = 1; index < result.length; index++)
{
print("submatch " + index + ": " + result[index]);
}
// Output:
// george@contoso.com
// submatch 1: george
// submatch 2: contoso
// submatch 3: com
Dieses Beispiel veranschaulicht die Verwendung der match-Methode, wenn das globale Kennzeichen (g) festgelegt ist.
var src = "Please send mail to george@contoso.com and someone@example.com. Thanks!";
// Create a regular expression to search for an e-mail address.
// The global flag is included.
var re = /(\w+)@(\w+)\.(\w+)/g;
var result = src.match(re);
// Because the global flag is included, the matches are in
// array elements 0 through n.
for (var index = 0; index < result.length; index++)
{
print(result[index]);
}
// Output:
// george@contoso.com
// someone@example.com
Die folgenden Codezeilen veranschaulichen die Verwendung eines Zeichenfolgenliterals mit der match-Methode.
var re = /th/i;
var result = "through the pages of this book".match(re);