Structural Pattern Matching

Expert Answer & Key Takeaways

Mastering Structural Pattern Matching is essential for high-fidelity technical performance and advanced exam competency in 2026.

Structural Pattern Matching (Match-Case)

Introduced in Python 3.10, match-case provides a declarative way to deconstruct and branch based on the structure of data, not just its value.

1. The Proof Code

from typing import Any

def process_command(command: list[str] | str) -> str:
    match command:
        case "QUIT":
            return "Exiting..."
        case ["LOAD", filename]:
            return f"Loading {filename}..."
        case ["MOVE", x, y] if int(x) > 0:
            return f"Moving to positive {x}, {y}"
        case ["MOVE", x, y]:
            return f"Moving to {x}, {y}"
        case _:
            return "Unknown command"

if __name__ == "__main__":
    print(process_command(["LOAD", "data.csv"]))  # Output: Loading data.csv...
    print(process_command(["MOVE", "10", "20"])) # Output: Moving to positive 10, 20
    print(process_command("QUIT"))               # Output: Exiting...

2. Execution Breakdown

Subject Evaluation: The expression after match is evaluated once.
Pattern Binding: In case ["LOAD", filename], if the subject is a list of two elements starting with "LOAD", the second element is automatically bound to the variable filename.
Guards: The if int(x) > 0 is a 'guard'. Even if the pattern matches, the case only executes if the guard is true.
Wildcard: The case _: acts as a 'catch-all' or default case.

3. Detailed Theory

Structural pattern matching is significantly more powerful than a simple switch statement. It allows for:

Sequence Matching: Matching against lists, tuples, or even nested structures.
Mapping Matching: Matching against dictionaries and extracting specific keys.
Class Matching: Matching against object types and attributes using case Point(x=x_val, y=y_val):.

Performance

Internally, the Python interpreter optimizes the decision tree for match statements, making them generally as fast as or faster than equivalent if-elif-else chains for complex structural checks.

[!TIP] Senior Secret: Use match-case for parsing JSON-like structures or AST nodes. It drastically reduces boilerplate code for 'drilling down' into nested data compared to multiple isinstance() and indexing checks.

Structural Pattern Matching

Expert Answer & Key Takeaways