test-Methode

Aktualisiert: November 2007

Gibt einen booleschen Wert zurück, der angibt, ob in einer durchsuchten Zeichenfolge ein Muster eines regulären Ausdrucks vorhanden ist.

function test(str : String) : Boolean

Argumente

  • str
    Erforderlich. Die zu durchsuchende Zeichenfolge.

Hinweise

Die test-Methode prüft, ob ein Muster in einer Zeichenfolge vorhanden ist und gibt true zurück, falls dies zutrifft. Andernfalls wird false zurückgegeben. Wird eine Übereinstimmung gefunden, werden die Eigenschaften des globalen RegExp-Objekts aktualisiert, um die Ergebnisse der Übereinstimmung wiederzugeben.

Wenn das globale Flag für einen regulären Ausdruck festgelegt wird, durchsucht test die Zeichenfolge beginnend an der Position, die durch den Wert von lastIndex angegeben wurde. Wenn das globale Flag nicht festgelegt wird, ignoriert test den Wert von lastIndex und durchsucht die Zeichenfolge von Anfang an.

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung der test-Methode. Übergeben Sie der Funktion ein Muster des regulären Ausdrucks und eine Zeichenfolge, damit Sie dieses Beispiel verwenden können. Die Funktion testet, ob das Muster des regulären Ausdrucks in der Zeichenfolge vorkommt, und gibt eine Zeichenfolge zurück, die die Ergebnisse dieser Suche anzeigt:

function TestDemo(re, s){
   var s1;                         //Declare variable.
   // Test string for existence of regular expression.
   if (re.test(s))                 //Test for existence.
      s1 = " contains ";           //s contains pattern.
   else
      s1 = " does not contain ";   //s does not contain pattern.
   return("'" + s + "'" + s1 + "'"+ re.source + "'"); //Return string.
}

Anforderungen

Version 3

Betrifft:

Regular Expression-Objekt

Siehe auch

Konzepte

Syntax regulärer Ausdrücke

Referenz

RegExp-Objekt