Regular Expression, objet

Article
08/10/2011

Objet contenant un modèle d'expression régulière ainsi que des indicateurs permettant de déterminer le mode d'application du modèle.

// The explicit constructor for a Regular Expression object.
function RegExp(pattern : String [,flags : String])
function RegExp(regexObj : System.Text.RegularExpressions.Regex)

// The implicit constructor for a Regular Expression object.
/pattern/[flags]

Arguments

Modèle
Obligatoire. Modèle d'expression régulière à utiliser. Si vous utilisez la syntaxe 1, le modèle doit être une chaîne. Si vous utilisez la syntaxe 2, le modèle est délimité par les caractères « / ».
flags
Facultatif. Si vous utilisez la syntaxe 1, les indicateurs (flags) doivent être représentés sous forme de chaîne. Si vous utilisez la syntaxe 2, les caractères des indicateurs doivent immédiatement suivre le dernier caractère « / ». Les indicateurs disponibles sont les suivants (toute combinaison est possible) :
- g (recherche globale de toutes les occurrences de pattern)
- i (ignorer la casse)
- m (recherche multiligne)
regexObj
Obligatoire. Objet Regex qui contient le modèle d'expression régulière à utiliser.

Notes

L'objet Regular Expression ne doit pas être confondu avec l'objet RegExp global. S'ils peuvent sembler identiques, ils présentent néanmoins plusieurs différences. Les propriétés de l'objet Regular Expression contiennent des informations relatives à une seule instance particulière de Regular Expression. En revanche, les propriétés de l'objet RegExp global contiennent des informations mises à jour en permanence sur chacune des correspondances trouvées.

Les objets Regular Expression stockent des modèles utilisés pour la recherche de combinaisons de caractères dans les chaînes. Dès que l'objet Regular Expression est créé, il est passé à une méthode de chaîne ou une chaîne est passée à une méthode de l'objet Regular Expression. Les informations concernant la recherche la plus récente sont stockées dans l'objet RegExp global.

Utilisez la syntaxe 1 lorsque la chaîne recherchée change fréquemment ou lorsqu'elle est inconnue, comme les chaînes dérivées d'entrées d'utilisateur. Utilisez la syntaxe 2 lorsque vous connaissez la chaîne recherchée à l'avance.

Dans JScript, l'argument pattern est compilé dans un format interne avant son utilisation. Pour la syntaxe 1, pattern est compilé immédiatement avant son emploi, ou lors de l'appel de la méthode compile. Pour la syntaxe 2, pattern est compilé lors du chargement du script.

Notes

L'objet Regular Expression interagit avec le type de données du .NET Framework System.Text.RegularExpressions.Regex dans JScript. En revanche, d'autres langages CLS (Common Language Specification) ne peuvent pas utiliser l'objet Regular Expression dans la mesure où JScript est le seul langage à fournir l'objet ; il n'est pas dérivé d'un type du .NET Framework. En conséquence, lors de l'annotation de type des paramètres et des types de retour des méthodes conformes à CLS, assurez-vous d'utiliser le type de données System.Text.RegularExpressions.Regex plutôt que l'objet Regular Expression. Vous pouvez néanmoins utiliser l'objet Regular Expression pour annoter le type d'identificateurs autres que des paramètres et des types de retour. Pour plus d'informations, consultez Écriture d'un code conforme CLS.

Exemple

L'exemple ci-dessous illustre l'utilisation de l'objet Regular Expression : les objets re1 et re2 sont créés et contiennent des modèles d'expressions régulières avec les indicateurs associés. Dans cet exemple, les objets Regular Expression obtenus sont ensuite utilisés par la méthode match :

var s : String = "The quick brown fox jumps over the lazy dog";
// Create regular expression object by using Syntax 1.
var re1 : RegExp = new RegExp("quick","i");
// Create regular expression object by using Syntax 2.
var re2 : RegExp = /THE/i;

// Find a match within string s.
print(s.match(re1));
print(s.match(re2));

Le résultat généré par ce script est le suivant :