JavaScript-String-Methode match()

Definition und Verwendung

match() Die Methode führt eine Übereinstimmung zwischen der Zeichenkette und dem regulären Ausdruck durch.

Hinweis:Wenn der Suchwert eine Zeichenkette ist, wird dieser in einen regulären Ausdruck umgewandelt.

match() Die Methode gibt das Array der Übereinstimmungsergebnisse zurück.

Wird kein Übereinstimmungsergebnis gefunden, dann match() Die Methode gibt zurück null.

Weitere Informationen siehe:

Regulärer Ausdruck Tutorial

Regulärer Ausdruck Referenzhandbuch

Unterschied zwischen String match() und String search()

match() Die Methode gibt das Array der Übereinstimmungen zurück.

search() Die Methode gibt die Position der ersten Übereinstimmung zurück.

Beispiel

Beispiel 1

Suche mit Zeichenkette nach "ain":

let text = "The rain in SPAIN stays mainly in the plain";
text.match("ain");

Versuchen Sie es selbst

Beispiel 2

Suche mit regulärem Ausdruck nach "ain":

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/);

Versuchen Sie es selbst

Beispiel 3

Globale Suche nach "ain":

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/g);

Versuchen Sie es selbst

Beispiel 4

Globale, nicht groß-/kleinschreibungsabhängige Suche:

let text = "The rain in SPAIN stays mainly in the plain";
text.match(/ain/gi);

Versuchen Sie es selbst

Syntax

string.match(regexp)

Parameter

Parameter Beschreibung
regexp

Erforderlich. Suchwert.

Regulärer Ausdruck (oder wird in einen regulären Ausdruck umgewandelt).

Rückgabewert

Typ Beschreibung
Array oder null

Array, das die Übereinstimmungsergebnisse enthält.

Wird kein Übereinstimmungsergebnis gefunden, wird null.

Technische Details

Parameter regexp

Dieser Parameter spezifiziert das RegExp-Objekt, das auf das zu passierende Muster angewendet werden soll. Wenn dieser Parameter kein RegExp-Objekt ist, wird er zunächst an den RegExp()-Konstruktor weitergeleitet und in ein RegExp-Objekt umgewandelt.

Rückgabewert

Array zum Speichern der Übereinstimmungsergebnisse. Der Inhalt dieses Arrays hängt davon ab, regexp ob der globalen Marker hat g. Nachfolgend wird dieser Rückgabewert im Detail erläutert.

Beschreibung

match() Methode wird den String stringum eine oder mehrere mit regexp übereinstimmenden Text. Das Verhalten dieser Methode hängt stark von regexp hat das Marker g.

wenn regexp ob match() ohne das Marker g, dann string Methode kann nurmatch() wird null. Wenn keine Übereinstimmungstexte gefunden werden, string Positionen, die das Attribut input erklärt, ist das string der Bezug

wenn regexp mit dem Marker gdann match() Methode führt eine globale Suche durch und findet string alle Übereinstimmungssubstrings in enthalten. Wenn keine Übereinstimmungssubstrings gefunden werden, wird null. Wenn eine oder mehrere Übereinstimmungssubstrings gefunden werden, wird eine Liste zurückgegeben. Die Inhalte der Liste, die durch die globale Übereinstimmung zurückgegeben wird, sind jedoch sehr unterschiedlich zu den letzteren. Die Elemente der Liste sind string enthält alle Übereinstimmungssubstrings und hat weder das Attribut index noch das Attribut input.

Hinweis:Im Modus der globalen Suchematch() Bietet keine Informationen über den Text, der mit den Unterexpressionen übereinstimmt, und gibt keine Positionen der jeder Übereinstimmung an. Wenn Sie diese globalen Suchinformationen benötigen, können Sie RegExp.exec().

Regulärer Ausdrucks-Suchmethode

In JavaScript können reguläre Ausdrucks-Textsuchen mit verschiedenen Methoden durchgeführt werden.

Durch die Verwendung des Musters als regulären Ausdruck sind dies die häufigsten Methoden:

Beispiel Beschreibung
text.match(Muster) Zeichenkettenmethode match()
text.search(Muster) Zeichenkettenmethode search()
Muster.exec(text) Regulärer Ausdrucksmethode exec()
Muster.test(text) Regulärer Ausdrucksmethode test()

Browser-Unterstützung

match() Es ist eine ECMAScript1 (ES1)-Eigenschaft.

Alle Browser unterstützen ES1 (JavaScript 1997) vollkommen:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Unterstützt Unterstützt Unterstützt Unterstützt Unterstützt Unterstützt

Verwandte Seiten

JavaScript-String

JavaScript-Stringmethoden

JavaScript-Stringsuche