match

  • Enlace amigable (slug) de la revisión: Referencia_de_JavaScript_1.5/Objetos_globales/String/match
  • Título de la revisión: match
  • Id de la revisión: 181354
  • Creada:
  • Creador: Talisker
  • ¿Es la revisión actual? No
  • Comentario New page: <breadcrumbs></breadcrumbs> == Resumen == Se usa para devolver los emparejamientos entre una ''cadena'' y una ''expresión regular''. <table class="fullwidth-table"> <tr> <td class="hea...

Contenido de la revisión

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

Sintaxis

match(expresionregular)

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).

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.

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.

Lectura Adicional

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

Ejemplos

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).

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á {{mediawiki.external('\'A\', \'B\', \'C\', \'D\', \'E\', \'a\', \'b\', \'c\', \'d\', \'e\'')}}

{{ wiki.languages( { "ja": "ja/Core_JavaScript_1.5_Reference/Global_Objects/String/match", "pl": "pl/Dokumentacja_j\u0119zyka_JavaScript_1.5/Obiekty/String/match" } ) }}

Fuente de la revisión

<p>
</p>
<h3 name="Resumen"> Resumen </h3>
<p>Se usa para devolver los emparejamientos entre una <i>cadena</i> y una <i>expresión regular</i>.
</p>
<table class="fullwidth-table">
<tbody><tr>
<td class="header" colspan="2">Método de <a href="es/Referencia_de_JavaScript_1.5/Objetos_globales/String">String</a></td>
</tr>
<tr>
<td>Implementado en:</td>
<td>JavaScript 1.2</td>
</tr>
<tr>
<td>Versión ECMA:</td>
<td>ECMA-262, Edición 3</td>
</tr>
</tbody></table>
<h3 name="Sintaxis"> Sintaxis </h3>
<p><code>
match(<i>expresionregular</i>)
</code>
</p>
<h3 name="Par.C3.A1metros"> Parámetros </h3>
<dl><dt> <code>expresionregular</code> </dt><dd> Un objeto <a href="es/Referencia_de_JavaScript_1.5/Objetos_globales/RegExp"> expresión regular</a>. Si se pasa un objeto <code>obj</code> que no es expresión regular, se convierte implícitamente a RegExp usando <code>new RegExp(obj)</code>.
</dd></dl>
<h3 name="Descripci.C3.B3n"> Descripción </h3>
<p>Si la expresión regular no incluye el flag <code>g</code>, devuelve el mismo resultado que <code><a href="es/Referencia_de_JavaScript_1.5/Objetos_globales/RegExp/exec"><i>regexp</i>.exec(<i>string</i>)</a></code>.
</p><p>Si la expresión regular incluye el flag <code>g</code>, el método devuelve un  <code><a href="es/Referencia_de_JavaScript_1.5/Objetos_globales/Array">Array</a></code> que contiene todos los emparejamientos.
</p>
<h4 name="Notas"> Notas </h4>
<ul><li> Si necesita conocer si una cadena se empareja con una expresión regular <code>regexp</code>, use <code><a href="es/Referencia_de_JavaScript_1.5/Objetos_globales/RegExp/test"><i>regexp</i>.test(<i>string</i>)</a></code>.
</li><li> Si sólo quiere el primer emparejamiento hallado, podría querer usar <code><a href="es/Referencia_de_JavaScript_1.5/Objetos_globales/RegExp/exec"><i>regexp</i>.exec(<i>string</i>)</a></code> a cambio. 
</li></ul>
<h3 name="Lectura_Adicional"> Lectura Adicional </h3>
<ul><li> Vea §15.5.4.10 de la especificación ECMA-262.
</li></ul>
<h3 name="Ejemplos"> Ejemplos </h3>
<h4 name="Ejemplo:_Usando_match"> Ejemplo: Usando <code>match</code> </h4>
<p>En el siguiente ejemplo, se usa <code>match</code> para hallar "<code>Capítulo</code>" 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 <code>i</code> por lo que las mayúsculas serán ignoradas.
</p>
<pre>&lt;SCRIPT&gt;
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);
&lt;/SCRIPT&gt;
</pre>
<p>Esto devuelve un arreglo que contiene Capítulo 3.4.5.1,Capítulo 3.4.5.1,.1
</p><p>"<code>Capítulo 3.4.5.1</code>" es el primer emparejamiento y el primer valor referenciado por <code>(Chapter \d+(\.\d)*)</code>.
</p><p>"<code>.1</code>" es el segundo valor referenciado por <code>(\.\d)</code>.
</p>
<h4 name="Ejemplo:_Usando_los_flags_global_e_ignorar_may.C3.BAsculas_con_match"> Ejemplo: Usando los flags global e ignorar mayúsculas con <code>match</code> </h4>
<p>El siguiente ejemplo demuestra el uso de los flags global e ignorar mayúsculas con <code>match</code>. Todas las letras de A hasta E y de a hasta e son devueltas, en su propio elemento dentro del arreglo.
</p>
<pre>var cadena = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
var expresion = /[A-E]/gi;
var arreglo_emparejamientos = cadena.match(expresion);
document.write(arreglo_emparejamientos);
</pre>
<p><code>arreglo_emparejamientos</code> será <code>{{mediawiki.external('\'A\', \'B\', \'C\', \'D\', \'E\', \'a\', \'b\', \'c\', \'d\', \'e\'')}}</code>
</p>
<div class="noinclude">
</div>
{{ wiki.languages( { "ja": "ja/Core_JavaScript_1.5_Reference/Global_Objects/String/match", "pl": "pl/Dokumentacja_j\u0119zyka_JavaScript_1.5/Obiekty/String/match" } ) }}
Revertir a esta revisión