Why str.contains() for pattern matching in Pandas? - Purpose & Use Cases

The Big Idea

What if you could find any word or phrase in thousands of texts instantly, without reading a single line?

The Scenario

Imagine you have a huge list of customer reviews and you want to find all reviews that mention the word "great" or "excellent".

Manually reading each review to find these words would take forever.

The Problem

Going through each review one by one is slow and tiring.

You might miss some because you skim too fast or get distracted.

Also, searching for variations like "Great!" or "EXCELLENT" manually is tricky.

The Solution

The str.contains() function lets you quickly check if a pattern or word appears in each text entry.

It works fast on big lists and can ignore case differences automatically.

This means you get all matching entries instantly without reading everything yourself.

Before vs After

✗ Before

matches = []
for review in reviews:
    if 'great' in review.lower() or 'excellent' in review.lower():
        matches.append(review)

✓ After

matches = reviews.str.contains('great|excellent', case=False, na=False)

What It Enables

You can instantly filter and analyze large text data by patterns, saving time and avoiding mistakes.

Real Life Example

A company analyzing thousands of customer feedback messages to find all comments mentioning "late delivery" or "damaged product" to improve service.

Key Takeaways

Manually searching text is slow and error-prone.

str.contains() quickly finds patterns in text data.

This helps analyze large datasets easily and accurately.

Practice

1. What does the str.contains() method do in pandas?

easy

A. It checks if a string pattern exists in each element of a Series.

B. It replaces strings matching a pattern with another string.

C. It counts the number of times a pattern appears in a Series.

D. It sorts the Series based on string length.

Solution

1. Step 1: Understand the purpose of str.contains()

   This method is used to check if each string element in a pandas Series contains a specific pattern.

2. Step 2: Compare with other string methods

   Replacing strings or counting occurrences are done by other methods like str.replace() or str.count(). Sorting is unrelated.

3. Final Answer:

   It checks if a string pattern exists in each element of a Series. -> Option A

4. Quick Check:

   str.contains() = check pattern presence [OK]

Hint: Remember: contains means 'is pattern inside?' [OK]

Common Mistakes:

• Confusing contains with replace
• Thinking it counts occurrences
• Assuming it sorts data

2. Which of the following is the correct syntax to find rows where column 'Name' contains the substring 'John' (case insensitive) in a DataFrame df?

easy

A. df[df['Name'].str.contains('John', ignore_case=True)]

B. df[df['Name'].contains('John', case=False)]

C. df[df['Name'].str.contains('John', case=True)]

D. df[df['Name'].str.contains('John', case=False)]

Solution

1. Step 1: Identify correct method and parameters

   The method is str.contains() and to ignore case, use case=False.

2. Step 2: Check syntax correctness

   df[df['Name'].str.contains('John', case=False)] uses correct method and parameter. df[df['Name'].contains('John', case=False)] misses str. df[df['Name'].str.contains('John', ignore_case=True)] uses wrong parameter ignore_case. df[df['Name'].str.contains('John', case=True)] sets case=True, which is case sensitive.

3. Final Answer:

   df[df['Name'].str.contains('John', case=False)] -> Option D

4. Quick Check:

   Use str.contains() with case=False [OK]

Hint: Use case=False for ignoring case in str.contains() [OK]

Common Mistakes:

• Forgetting to use str accessor
• Using wrong parameter name like ignore_case
• Setting case=True when case insensitive needed

3. Given the DataFrame df below, what is the output of df['City'].str.contains('York', na=False)?

import pandas as pd
df = pd.DataFrame({'City': ['New York', 'Yorkshire', None, 'Los Angeles']})

medium

A. [False, True, False, False]

B. [True, False, False, False]

C. [True, True, False, False]

D. [True, True, True, False]

Solution

1. Step 1: Check each element for 'York'

   'New York' contains 'York' (True), 'Yorkshire' contains 'York' (True), None is missing so replaced by False due to na=False, 'Los Angeles' does not contain 'York' (False).

2. Step 2: Construct boolean Series output

   The result is [True, True, False, False].

3. Final Answer:

   [True, True, False, False] -> Option C

4. Quick Check:

   Check each string for 'York' with na=False [OK]

Hint: Use na=False to handle missing values safely [OK]

Common Mistakes:

• Ignoring missing values causing errors
• Assuming None matches pattern
• Misreading which strings contain 'York'

4. What is wrong with this code snippet?

df[df['Email'].str.contains('@gmail.com')]

Assume some values in 'Email' column are missing (NaN).

medium

A. It will return all rows because '@gmail.com' matches everything.

B. It will raise an error due to missing values without handling na parameter.

C. It will ignore case sensitivity by default causing wrong results.

D. It will convert all emails to lowercase automatically.

Solution

1. Step 1: Understand missing data impact on str.contains()

   If the column has NaN values, str.contains() raises an error unless na parameter is set.

2. Step 2: Check code for na parameter

   The code does not set na=False, so it will raise an error when encountering NaN.

3. Final Answer:

   It will raise an error due to missing values without handling na parameter. -> Option B

4. Quick Check:

   Missing na causes errors with NaN [OK]

Hint: Always add na=False to avoid errors with missing data [OK]

Common Mistakes:

• Ignoring NaN causes runtime error
• Assuming default ignores case or missing data
• Thinking it auto-lowers case

5. You have a DataFrame df with a column 'Description' containing product details. You want to filter rows where 'Description' contains either 'red' or 'blue' (case insensitive), but some rows have missing values. Which code snippet correctly does this?

hard

A. df[df['Description'].str.contains('red|blue', case=False, na=False)]

B. df[df['Description'].str.contains('red|blue', case=True)]

C. df[df['Description'].str.contains('red|blue', na=True)]

D. df[df['Description'].str.contains('red|blue', case=False)]

Solution

1. Step 1: Use regex pattern for multiple options

   To match 'red' or 'blue', use the regex pattern 'red|blue'.

2. Step 2: Handle case insensitivity and missing values

   Set case=False for ignoring case and na=False to avoid errors on missing data.

3. Step 3: Verify options

   df[df['Description'].str.contains('red|blue', case=False, na=False)] correctly uses both case=False and na=False. df[df['Description'].str.contains('red|blue', case=True)] is case sensitive. df[df['Description'].str.contains('red|blue', na=True)] uses invalid na=True. df[df['Description'].str.contains('red|blue', case=False)] misses na=False.

4. Final Answer:

   df[df['Description'].str.contains('red|blue', case=False, na=False)] -> Option A

5. Quick Check:

   Use regex with case=False and na=False [OK]

Hint: Use regex 'red|blue' with case=False and na=False [OK]

Common Mistakes:

• Forgetting na=False causes errors
• Using case sensitive search unintentionally
• Wrong regex or missing regex for multiple patterns