Regular Expression (Objeto)

Artículo
10/07/2008

Actualización: noviembre 2007

Objeto que contiene un modelo de expresión regular junto con indicadores que muestran cómo aplicarlo.

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

Argumentos

pattern
Necesario. Modelo de expresión regular que se va a utilizar. Si utiliza la sintaxis 1, el modelo debe ser una cadena. Si utiliza la sintaxis 2, delimite el modelo con caracteres "/".
flags
Opcional. Si utiliza la sintaxis 1, los indicadores deberán ser una cadena. Si utiliza la sintaxis 2, los caracteres de los indicadores seguirán inmediatamente al último carácter "/". Los indicadores disponibles que se pueden combinar son:
- g (búsqueda global para todas las repeticiones del argumento pattern)
- i (pasar por alto mayúsculas y minúsculas)
- m (búsqueda en varias líneas)
regexObj
Necesario. Objeto Regex que contiene el modelo de expresión regular que se debe utilizar.

Comentarios

El objeto Regular Expression no debe confundirse con el objeto global RegExp. Aunque suenen igual, pueden distinguirse con facilidad. Las propiedades del objeto Regular Expression contienen sólo información sobre una instancia particular de Regular Expression, mientras que las propiedades del objeto global RegExp contienen información continuamente actualizada sobre cada coincidencia que tiene lugar.

Los objetos Regular Expression almacenan modelos utilizados al buscar cadenas para combinaciones de caracteres. Una vez creado el objeto Regular Expression, se pasa a un método de cadena o se pasa a una cadena un método del objeto Regular Expression. La información sobre la búsqueda realizada más recientemente se almacena en el objeto global RegExp.

Utilice la sintaxis 1 cuando la cadena de búsqueda cambie con frecuencia o no se conozca, como ocurre con las cadenas derivadas de entradas de usuario. Utilice la sintaxis 2 cuando conozca la cadena de búsqueda con antelación.

En JScript, el argumento pattern se compila en un formato interno antes de ser utilizado. Para la sintaxis 1, el modelo se compila antes de ser utilizado o en el momento de llamar al método compile. Para la sintaxis 2, el modelo se compila cuando se carga la secuencia de comandos.

Nota:
El objeto Regular Expression interopera con el tipo de datos System.Text.RegularExpressions.Regex de .NET Framework en JScript. Sin embargo, otros lenguajes CLS (Common Language Specification, Especificación común de lenguajes) no pueden utilizar el objeto Regular Expression porque sólo lo proporciona JScript; no deriva de un tipo de .NET Framework. Por consiguiente, al anotar los parámetros y los tipos de valor devueltos de los métodos compatibles con CLS, asegúrese de utilizar el tipo de datos System.Text.RegularExpressions.Regex en lugar del objeto Regular Expression. Sin embargo, puede utilizar el objeto Regular Expression para anotar el tipo de identificadores que no sean ni parámetros ni tipos de valor devueltos. Para obtener más información, vea Escribir código compatible con CLS.

El objeto Regular Expression interopera con el tipo de datos System.Text.RegularExpressions.Regex de .NET Framework en JScript. Sin embargo, otros lenguajes CLS (Common Language Specification, Especificación común de lenguajes) no pueden utilizar el objeto Regular Expression porque sólo lo proporciona JScript; no deriva de un tipo de .NET Framework. Por consiguiente, al anotar los parámetros y los tipos de valor devueltos de los métodos compatibles con CLS, asegúrese de utilizar el tipo de datos System.Text.RegularExpressions.Regex en lugar del objeto Regular Expression. Sin embargo, puede utilizar el objeto Regular Expression para anotar el tipo de identificadores que no sean ni parámetros ni tipos de valor devueltos. Para obtener más información, vea Escribir código compatible con CLS.

Ejemplo

El siguiente ejemplo muestra el uso del objeto Regular Expression. Los objetos re1 y re2 se crean y contienen modelos de expresión regular con los indicadores asociados. En este caso, los objetos Regular Expression resultantes son utilizados por el método 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));

El resultado de esta secuencia de comandos es: