Oggetto Regular Expression

Articolo
09/12/2008

Aggiornamento: novembre 2007

Oggetto che include un criterio di ricerca di espressioni regolari insieme a flag che specificano come applicarlo.

// 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]

Argomenti

pattern
Obbligatorio. Il criterio di ricerca di espressioni regolari che deve essere utilizzato. Se si utilizza la sintassi 1, il criterio deve essere rappresentato da una stringa. Se si utilizza la sintassi 2, il criterio deve essere delimitato dai caratteri "/".
flags
Facoltativo. Se si utilizza la sintassi 1, i flag devono essere contenuti in una stringa. Se si utilizza la sintassi 2, i caratteri flag devono seguire immediatamente l'ultimo carattere "/". Di seguito sono elencati i flag disponibili che possono essere combinati:
- g (ricerca globale di tutte le occorrenze di pattern)
- i (ignora maiuscole/minuscole)
- m (ricerca su più righe)
regexObj
Obbligatorio. Un oggetto Regex contenente il criterio di ricerca di espressioni regolari che deve essere utilizzato.

Note

L'oggetto Regular Expression non deve essere confuso con l'oggetto globale RegExp. Benché possano sembrare simili, sono in realtà due oggetti distinti. Le proprietà dell'oggetto Regular Expression contengono solo informazioni su una particolare istanza di Regular Expression, mentre le proprietà dell'oggetto globale RegExp contengono informazioni continuamente aggiornate su ciascuna corrispondenza non appena questa si verifica.

Negli oggetti Regular Expression vengono memorizzati i criteri utilizzati per la ricerca di stringhe con specifiche combinazioni di caratteri. Dopo essere stato creato, l'oggetto Regular Expression viene passato a un metodo string oppure una stringa viene passata a uno dei metodi dell'oggetto. Le informazioni sull'ultima ricerca eseguita vengono memorizzate nell'oggetto globale RegExp.

Utilizzare la sintassi 1 quando la stringa di ricerca cambia di frequente oppure è sconosciuta, come nel caso di stringhe di input dell'utente. Utilizzare la sintassi 2 quando si conosce in anticipo la stringa da cercare.

In JScript l'argomento pattern, prima di essere utilizzato, viene compilato in un formato interno. Se si utilizza la sintassi 1, l'argomento pattern viene compilato immediatamente prima di essere utilizzato oppure quando si chiama il metodo compile. Se si utilizza la sintassi 2, questa operazione viene eseguita al caricamento dello script.

Nota:
L'oggetto Regular Expression interagisce con il tipo di dati System.Text.RegularExpressions.Regex di .NET Framework all'interno di JScript. Tuttavia, poiché l'oggetto viene fornito solamente da JScript e non deriva da un tipo .NET Framework, non è possibile utilizzare tale oggetto con altri linguaggi compatibili con CLS (Common Language Specification). Per tale motivo, durante l'annotazione del tipo di parametri e tipi restituiti dei metodi compatibili con CLS, assicurarsi di utilizzare il tipo di dati System.Text.RegularExpressions.Regex anziché l'oggetto Regular Expression. È possibile tuttavia utilizzare l'oggetto Regular Expression per l'annotazione del tipo di identificatori diversi dai parametri o dai tipi restituiti. Per ulteriori informazioni, vedere Scrittura di codice compatibile con CLS.

L'oggetto Regular Expression interagisce con il tipo di dati System.Text.RegularExpressions.Regex di .NET Framework all'interno di JScript. Tuttavia, poiché l'oggetto viene fornito solamente da JScript e non deriva da un tipo .NET Framework, non è possibile utilizzare tale oggetto con altri linguaggi compatibili con CLS (Common Language Specification). Per tale motivo, durante l'annotazione del tipo di parametri e tipi restituiti dei metodi compatibili con CLS, assicurarsi di utilizzare il tipo di dati System.Text.RegularExpressions.Regex anziché l'oggetto Regular Expression. È possibile tuttavia utilizzare l'oggetto Regular Expression per l'annotazione del tipo di identificatori diversi dai parametri o dai tipi restituiti. Per ulteriori informazioni, vedere Scrittura di codice compatibile con CLS.

Esempio

Nell'esempio seguente viene illustrato l'utilizzo dell'oggetto Regular Expression. Vengono creati gli oggetti re1 e re2 in cui sono contenuti i criteri di ricerca di espressioni regolari con i flag associati. In questo caso, gli oggetti Regular Expression risultanti vengono utilizzati dal metodo match:

var s : String = "The rain in Spain falls mainly in the plain";
// Create regular expression object using Syntax 1.
var re1 : RegExp = new RegExp("Spain","i");
// Create regular expression object using Syntax 2.
var re2 : RegExp = /IN/i;

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

L'output dello script è il seguente: