match, méthode
Mise à jour : novembre 2007
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 la méthode exec pour laquelle l'indicateur global (g) n'a pas été défini. Si ce dernier est défini, les éléments 0 - n contiennent toutes les correspondances qui ont été trouvées.
Exemple
L'exemple ci-dessous illustre l'utilisation de la méthode match.
function MatchDemo(){
var r, re; //Declare variables.
var s = "The rain in Spain falls mainly in the plain";
re = /ain/i; //Create regular expression pattern.
r = s.match(re); //Attempt match on search string.
return(r); //Return first occurrence of "ain".
}
Cet exemple illustre l'utilisation de la méthode match lorsque l'indicateur g est défini.
function MatchDemo(){
var r, re; //Declare variables.
var s = "The rain in Spain falls mainly in the plain";
re = /ain/ig; //Create regular expression pattern.
r = s.match(re); //Attempt match on search string.
return(r); //Return array containing all four
// occurrences of "ain".
}
Les lignes de code suivantes illustrent l'utilisation d'un littéral de chaîne avec la méthode match.
var r, re = "Spain";
r = "The rain in Spain".replace(re, "Canada");