exec-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 exec(str : String) : Array
Argumente
- str
Erforderlich. Das String-Objekt oder Zeichenfolgenliteral, in dem gesucht werden soll.
Hinweise
Wenn die exec-Methode keine Übereinstimmung findet, gibt sie den Wert null zurück. Wenn sie eine Übereinstimmung findet, gibt exec ein Array zurück, und die Eigenschaften des globalen RegExp-Objekts werden aktualisiert, um die Ergebnisse der Übereinstimmung anzuzeigen. Das Element 0 des Arrays enthält die gesamte Übereinstimmung, während die Elemente 1 –n alle innerhalb der Übereinstimmung aufgetretenen Teilübereinstimmungen enthalten. Dieses Verhalten entspricht dem Verhalten der match-Methode ohne festgelegtes globales Flag (g).
Wenn das globale Flag für einen regulären Ausdruck festgelegt wird, durchsucht exec die Zeichenfolge beginnend an der Position, die durch den Wert von lastIndex angegeben wurde. Wenn das globale Flag nicht festgelegt wird, ignoriert exec den Wert von lastIndex und durchsucht die Zeichenfolge von Anfang an.
Das von der exec-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 Übereinstimmung folgt.
Beispiel
Das folgende Beispiel veranschaulicht die Verwendung der exec-Methode:
function RegExpTest() {
var s = "";
var src = "The rain in Spain falls mainly in the plain.";
// Create regular expression pattern for matching a word.
var re = /\w+/g;
var arr;
// Loop over all the regular expression matches in the string.
while ((arr = re.exec(src)) != null)
s += arr.index + "-" + arr.lastIndex + "\t" + arr + "\n";
return s;
}