Connect with Amin Boulouma Official

🏠 Documentation Hub 📝 Engineering Blog 💻 GitHub Repository

Multi-Pattern Matching: Beyond Single StartsWith

Amin Boulouma, Software Engineer

When writing parsers, command-line interfaces, or stream processors, you often need to check if a string begins with any one of several characters or prefixes. The naive approach, chaining or statements, is not only verbose but difficult to maintain.

The Problem: The “OR” Chain Trap

Checking multiple prefixes using standard boolean logic creates “visual noise” that hides your actual business logic.

# The verbose, fragile approach
if line.startswith('* ') or line.startswith('- ') or line.startswith('# '):
    # This becomes unreadable as you add more patterns
    process_list_item(line)

The Solution: Tuple-Based startswith()

Python’s startswith() method accepts a tuple of strings as an argument. If the input string matches any item in that tuple, the method returns True.

The Pythonic Pattern

# Clean, maintainable, and readable
MARKDOWN_LIST_PREFIXES = ('* ', '- ', '# ')

if line.startswith(MARKDOWN_LIST_PREFIXES):
    process_list_item(line)

Why Tuple-Matching Wins

1. Readability: The separation of the data (the prefixes) from the logic (the startswith check) makes your code significantly easier to scan.
2. Scalability: Adding a new prefix is as simple as adding a string to the MARKDOWN_LIST_PREFIXES tuple, rather than modifying the core logic flow.
3. Performance: Python performs this check efficiently in C, often outperforming manually chained or statements which require separate Python-level checks for each condition.

Beyond Prefixes: Real-World Applications

• Log Parsing: Filter log lines based on multiple severity levels: if line.startswith(('ERROR', 'CRITICAL', 'FATAL')):
• Security/Validation: Restrict user input to specific starting patterns: if input_str.startswith(('http://', 'https://')):
• Automation Command Sets: Identify specific control sequences in a stream: if command.startswith(('STOP', 'EXIT', 'QUIT')):

Best Practices

• Use Constants: Store your prefix tuples in uppercase, module-level constants (e.g., VALID_COMMANDS = ('CMD1', 'CMD2')) to indicate that they are configuration data, not transient logic.
• Normalize Input First: If your input has inconsistent whitespace or casing, call .strip() or .upper() on the string before passing it to startswith().
• Mind the Tuple: A common mistake is to pass a list instead of a tuple. startswith() strictly requires a tuple or a single string; startswith(['* ', '- ']) will raise a TypeError.

By leveraging tuple-based matching, you reduce conditional complexity and turn “if-else” spaghetti into precise, readable declaration-based logic.

Connect with Amin Boulouma Official