Metodo match
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
Obbligatoria. 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 comportamento del metodo Metodo exec quando il flag globale non è impostato sul metodo. 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 quando il flag globale (g) non è impostato:
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
In questo esempio viene illustrato l'utilizzo del metodo match con il flag globale (g) impostato.
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
Nelle seguenti righe di codice è illustrato l'utilizzo di un valore letterale stringa con il metodo match.
var re = /th/i;
var result = "through the pages of this book".match(re);