Referencia de JavaScript 1.5:Objetos globales:String:match

De MDC

Tabla de contenidos 1 Resumen 2 Sintaxis 3 Parámetros 4 Descripción 4.1 Notas 5 Lectura Adicional 6 Ejemplos 6.1 Ejemplo: Usando match 6.2 Ejemplo: Usando los flags global e ignorar mayúsculas con match

[editar] Resumen

Se usa para devolver los emparejamientos entre una cadena y una expresión regular.

Método de String
Implementado en:	JavaScript 1.2
Versión ECMA:	ECMA-262, Edición 3

[editar] Sintaxis

match(expresionregular)

[editar] Parámetros

expresionregular 

Un objeto expresión regular. Si se pasa un objeto obj que no es expresión regular, se convierte implícitamente a RegExp usando new RegExp(obj).

[editar] Descripción

Si la expresión regular no incluye el flag g, devuelve el mismo resultado que regexp.exec(string).

Si la expresión regular incluye el flag g, el método devuelve un Array que contiene todos los emparejamientos.

[editar] Notas

• Si necesita conocer si una cadena se empareja con una expresión regular regexp, use regexp.test(string).
• Si sólo quiere el primer emparejamiento hallado, podría querer usar regexp.exec(string) a cambio.

[editar] Lectura Adicional

• Vea §15.5.4.10 de la especificación ECMA-262.

[editar] Ejemplos

[editar] Ejemplo: Usando match

En el siguiente ejemplo, se usa match para hallar "Capítulo" seguido de 1 o más caracteres numéricos seguidos de un punto decimal y caracteres numéricos cero o más veces. La expresión regular incluye el flag i por lo que las mayúsculas serán ignoradas.

<SCRIPT>
cadena = "Para más información, vea Capítulo 3.4.5.1";
expresion = /(capítulo \d+(\.\d)*)/i;
hallado = cadena.match(expresion);
document.write(hallado);
</SCRIPT>

Esto devuelve un arreglo que contiene Capítulo 3.4.5.1,Capítulo 3.4.5.1,.1

"Capítulo 3.4.5.1" es el primer emparejamiento y el primer valor referenciado por (Chapter \d+(\.\d)*).

".1" es el segundo valor referenciado por (\.\d).

[editar] Ejemplo: Usando los flags global e ignorar mayúsculas con match

El siguiente ejemplo demuestra el uso de los flags global e ignorar mayúsculas con match. Todas las letras de A hasta E y de a hasta e son devueltas, en su propio elemento dentro del arreglo.

var cadena = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
var expresion = /[A-E]/gi;
var arreglo_emparejamientos = cadena.match(expresion);
document.write(arreglo_emparejamientos);

arreglo_emparejamientos será ['A', 'B', 'C', 'D', 'E', 'a', 'b', 'c', 'd', 'e']