RegExp

NN 4 IE 4 ECMA 3

L'objet statique RegExp a une double fonction: il génère des instances d'une expression régulière et contrôle toutes les expressions régulières de la fenêtre ou du cadre considéré. Les instances de l'objet RegExp sont présentées dans la description de l'objet expression régulière à la suite de cette section.

Les expressions régulières facilitent la recherche de textes correspondant à des combinaisons de caractères ou de caractéristiques. Par exemple, une expression régulière permet de déterminer très rapidement si l'entrée d'un champ de texte est un nombre à cinq chiffres. Pour définir le modèle de correspondance, il faut connaître la syntaxe de notation qui n'est pas traitée dans ce manuel (vous trouverez toutes les informations nécessaires à ce sujet dans l'ouvrage de Jeffrey E.F. Friedl, Mastering Regular Expressions, publié par O'Reilly). La description de l'objet expression régulière contient une brève présentation de la syntaxe.

Les propriétés de l'objet RegExp stockent des informations sur la dernière opération d'une expression régulière dans le document. Par conséquent, il est parfaitement concevable que chaque propriété change après une opération d'expression régulière. Ces opérations incluent non seulement les méthodes d'une instance d'objet expression régulière (exec() et test()), mais aussi les méthodes d'objet String qui acceptent des expressions régulières comme paramètres (match(), replace() et split()). Certaines de ces propriétés sont également passées à l'objet expression régulière, en prévision de la prochaine opération d'expression régulière.

Outre un nom descriptif, chaque propriété porte également un nom raccourci commençant par le signe $.

Propriétés

index	input	lastIndex	lastMatch	lastParen	leftContext
multiline	prototype	rightContext	$1	$2	$3
$4	$5	$6	$7	$8	$9

index	NN s.o. IE 4 ECMA s.o.
	Lecture seule
Valeur d'index à base zéro correspondant à la position du caractère de la chaîne où a commencé la dernière recherche du modèle. La propriété lastIndex fournit la position de fin.

Exemple

var srchStart = RegExp.index;

Valeur
Nombre entier.

input	NN 4 IE 4 ECMA s.o.
	Lecture/écriture
Chaîne principale à laquelle une expression régulière est comparée. Si la chaîne principale est passée à l'opération d'expression régulière comme paramètre pour une méthode, cette valeur est null. La version courte est $_ (signe dollar, caractère de soulignement).

Exemple

RegExp.input = "Four score and seven years ago...";

Valeur
Chaîne.

lastIndex	NN s.o. IE 4 ECMA s.o.
	Lecture/écriture
Valeur d'index à base zéro correspondant au caractère de la chaîne où commence la prochaine recherche du modèle. Dans une recherche, la valeur est égale à zéro. Vous pouvez également définir la valeur manuellement si vous souhaitez commencer à un autre emplacement ou omettre certains caractères. Cette propriété est reflétée dans l´instance d´objet de l´expression régulière et c´est là qu´elle est prise en charge dans Navigator.

Exemple

myRE.lastIndex = 30;

Valeur
Nombre entier.

lastMatch	NN 4 IE 5(Mac)/5.5(Win) ECMA s.o.
	Lecture seule
Renvoie la chaîne correspondant à l'expression régulière, suite à la dernière opération. La version courte est $&.

Exemple

var matched = RegExp.lastMatch;

Valeur
Chaîne.

lastParen	NN 4 IE 5(Mac)/5.5(Win) ECMA s.o.
	Lecture seule
Renvoie la chaîne correspondant au dernier sous-composant entre parenthèses de l'expression régulière résultant de la dernière opération. La version courte est $+.

Exemple

var myValue = RegExp.lastParen;

Valeur
Chaîne.

leftContext, rightContext	NN 4 IE 5(Mac)/5.5(Win) ECMA s.o.
	Lecture seule
La propriété leftContext renvoie la chaîne commençant par le début du dernier texte recherché et se terminant juste avant l'occurrence de la chaîne. La propriété rightContext renvoie la chaîne commençant par la partie de la chaîne principale située juste derrière l'occurrence trouvée et s'étendant jusqu'à la fin de la chaîne. Les versions courtes sont respectivement $` et $'. Etant donné que l'exécution de recherches successives sur une même chaîne principale se déplace inéluctablement vers la fin de celle-ci, le point de départ de la valeur leftContext peut être décalé à chaque opération.

Exemple

var wholeContext = RegExp.leftContext + RegExp.lastMatch + RegExp.rightContext;

Valeur
Chaîne.

multiline	NN 4 IE 5(Mac)/5.5(Win) ECMA 3
	Lecture/écriture
Si la recherche porte sur plusieurs lignes de texte, la propriété multiline est définie sur true. Par exemple, une recherche dans le texte d'un élément textarea est de multilignes. La version courte est $*.

Exemple

if (RegExp.multiline) { ... }

Valeur
Booléen.

$1, ..., $9	NN 4 IE 4 ECMA s.o.
	Lecture seule
Sous-composants entre parenthèses des résultats renvoyés par une expression régulière. Ces résultats sont stockés individuellement dans des propriétés libellées de 1 à 9 et précédées du symbole de raccourci $. L'ordre dépend de la position de la parenthèse de gauche d'un sous-composant: Le résultat du sous-composant à l´extrême gauche est placé dans $1. Ces propriétés peuvent être insérées directement dans des paramètres de méthodes String qui utilisent des expressions régulières (voir la méthode String.replace()).

Exemple

RegExp.$2

Valeur
Chaîne.