Método match del módulo re

El método match del módulo re busca solo una coincidencia con expresión regular al inicio de la cadena. En el primer parámetro del método especificamos la expresión regular que buscaremos, en el segundo parámetro - la cadena en la que la buscamos. En el tercer parámetro opcional se pueden establecer banderas para configuraciones adicionales de la expresión regular. El método devuelve un objeto Match object. Si no se encuentran coincidencias, se devuelve None.

Sintaxis

import re

re.match(expresión_regular, cadena, [banderas])

Ejemplo

Busquemos todas las subcadenas con dígitos:

txt = '123 456 789'
res = re.match('\d+', txt)

print(res)

Resultado de la ejecución del código:

<re.Match object; span=(0, 3), match='123'>

Ejemplo

Y ahora que nuestra cadena comience con caracteres alfabéticos:

txt = 'aaaa 123 456 789'
res = re.match('\d+', txt)

print(res)

Resultado de la ejecución del código:

None

Véase también

método findall del módulo re,
que devuelve una lista de todas las coincidencias en la cadena
método finditer del módulo re,
que devuelve un iterador de todas las coincidencias con la expresión regular en la cadena
método search del módulo re,
que busca la primera coincidencia con la expresión regular en la cadena
método fullmatch del módulo re,
que busca todas las coincidencias con la expresión regular en la cadena
objeto Match object del módulo re,
que contiene información sobre las coincidencias con la expresión regular