Metodo match
Aggiornamento: novembre 2007
Consente di eseguire una ricerca in una stringa utilizzando un criterio di espressione regolare e restituisce una matrice contenente i risultati della ricerca.
function match(rgExp : RegExp) : Array
Argomenti
- rgExp
Obbligatorio. Istanza di un oggetto Regular Expression contenente il criterio di espressione regolare e i flag applicabili. Può anche essere un nome di variabile o un valore letterale stringa contenente il criterio di espressione regolare e i flag.
Note
Se mediante il metodo match non viene trovata alcuna corrispondenza, verrà restituito null. In caso contrario, verrà restituita una matrice e le proprietà dell'oggetto globale RegExp verranno aggiornate per riflettere i risultati di tale corrispondenza.
La matrice restituita dal metodo match ha tre proprietà: input, index e lastIndex. La proprietà input contiene l'intera stringa cercata. La proprietà index contiene la posizione della sottostringa corrispondente all'interno dell'intera stringa cercata. La proprietà lastIndex contiene la posizione oltre l'ultimo carattere trovato nella ricerca effettuata.
Se il flag globale (g) non è impostato, l'elemento zero della matrice conterrà l'intera corrispondenza, mentre gli elementi da 1 a n conterranno le sottocorrispondenze della corrispondenza. Il funzionamento è identico a quello del metodo exec senza il flag globale impostato. Con il flag globale impostato, gli elementi da 0 a n includono tutte le corrispondenze.
Esempio
Nell'esempio seguente viene illustrato l'utilizzo del metodo 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".
}
Nell'esempio seguente viene illustrato l'utilizzo del metodo match con il flag g impostato.
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".
}
Nelle seguenti righe di codice è illustrato l'utilizzo di un valore letterale stringa con il metodo match.
var r, re = "Spain";
r = "The rain in Spain".replace(re, "Canada");