Regular Expression (Objeto)

Artículo
08/10/2011

Objeto que contiene un modelo de expresión regular junto con marcas 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

Modelo de
Obligatorio. 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, las marcas deberán ser una cadena. Si utiliza la sintaxis 2, los caracteres de las marcas seguirán inmediatamente al último carácter "/". Los marcadores 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
Obligatorio. 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 el script.

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 conformes a 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 conforme a 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 las marcas asociadas. En este caso, los objetos Regular Expression resultantes son utilizados por el método match:

var s : String = "The quick brown fox jumps over the lazy dog";
// Create regular expression object by using Syntax 1.
var re1 : RegExp = new RegExp("quick","i");
// Create regular expression object by using Syntax 2.
var re2 : RegExp = /THE/i;

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

El resultado de este script es: