Partager via


match, méthode

Exécute une recherche sur une chaîne à l'aide d'un modèle d'expression régulière et retourne, sous forme de tableau, les résultats de cette recherche.

function match(rgExp : RegExp) : Array

Arguments

  • rgExp
    Obligatoire. Instance d'un objet Regular Expression contenant le modèle d'expression régulière et les indicateurs applicables. Cet argument peut également être le nom d'une variable ou un littéral de chaîne contenant le modèle d'expression régulière et les indicateurs.

Notes

Si la méthode match ne trouve aucune correspondance, elle retourne la valeur null. Dans le cas contraire, match retourne un tableau, et les propriétés de l'objet RegExp global sont mises à jour pour refléter les résultats de la recherche.

Le tableau retourné par la méthode match possède trois propriétés, à savoir input, index et lastIndex. La propriété input contient la chaîne recherchée dans son intégralité. La propriété index contient la position de la sous-chaîne trouvée à l'intérieur de la chaîne recherchée complète. La propriété lastIndex contient la position de l'index suivant le dernier caractère de la dernière correspondance trouvée.

Si l'indicateur global (g) n'est pas défini, l'élément zéro du tableau contient la chaîne correspondante intégrale ; les éléments 1 – n contiennent les sous-chaînes trouvées à l'intérieur de la correspondance. Ce comportement est identique à celui de exec, méthode dans lequel l'indicateur global n'est pas défini sur la méthode. Si ce dernier est défini, les éléments 0 - n contiennent toutes les correspondances qui ont été trouvées.

Exemple

L'exemple suivant illustre l'utilisation de la méthode match lorsque l'indicateur global (g) n'est pas défini.

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

Cet exemple illustre l'utilisation de la méthode match lorsque l'indicateur global g est défini.

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

Les lignes de code suivantes illustrent l'utilisation d'un littéral de chaîne avec la méthode match.

var re = /th/i;
var result = "through the pages of this book".match(re);

Configuration requise

Version 3

S'applique à :

String, objet

Voir aussi

Référence

exec, méthode

RegExp, objet

Regular Expression, objet

replace, méthode

search, méthode

test, méthode

Concepts

Programmation des expressions régulières