Python re.match vs re.search vs re.findall

Python’s re module offers multiple functions to parse and extract text using regular expressions, but each searches strings differently and returns distinct data structures. This article breaks down the practical differences between re.match(), re.search(), and re.findall(), demonstrating how they locate patterns, what they return, and how to choose the right function for your task.

re.match(): Matches from the Beginning

re.match() determines if the regular expression matches only at the very beginning of the target string. If the pattern does not match the initial character(s), the function immediately returns None, even if the pattern appears later in the string.

• Scan Behavior: Scans strictly from index 0.
• Return Value: A single Match object if a match exists at the start; otherwise, None.
• Common Use Case: Validating input formats (e.g., verifying that an input starts with a specific prefix).

import re

text = "Error 404: Not Found"

# Matches because the pattern is at the start
result = re.match(r"\w+", text)
print(result.group())  # Output: Error

# Fails because digits are not at the start
result = re.match(r"\d+", text)
print(result)  # Output: None

re.search(): Finds the First Match Anywhere

re.search() scans the entire string from left to right to find the first location where the regular expression produces a match. Unlike re.match(), the match does not have to be at the beginning of the string.

• Scan Behavior: Scans through the entire string until the first match is found.
• Return Value: A single Match object for the first occurrence; otherwise, None.
• Common Use Case: Checking for the presence of a pattern or extracting the first instance of a pattern anywhere within a block of text.

import re

text = "Error 404: Not Found"

# Finds the first occurrence of digits anywhere in the text
result = re.search(r"\d+", text)
print(result.group())  # Output: 404

re.findall(): Finds All Matches

re.findall() scans the entire string and extracts all non-overlapping occurrences of the pattern. Instead of returning a Match object, it returns the matched data directly.

• Scan Behavior: Scans the entire string comprehensively.
• Return Value: A Python list containing all matches. If the pattern contains no capturing groups, it returns a list of strings. If the pattern contains capturing groups, it returns a list of tuples containing the groups. If no matches are found, it returns an empty list ([]).
• Common Use Case: Extracting repeated items, such as gathering all email addresses, URLs, or phone numbers from a document.

import re

text = "Item 1 costs $15, Item 2 costs $30, Item 3 costs $45"

# Finds all digit sequences throughout the string
result = re.findall(r"\d+", text)
print(result)  # Output: ['1', '15', '2', '30', '3', '45']

Key Differences Summary