Skip to main content
HomeAbout PythonLearn Python

Python String Contains

Sep 2020  · 5 min read

If you are looking to find or replace items in a string, Python has several built-in methods that can help you search a target string for a specified substring.

.find() Method


string.find(substring, start, end)

Note: start and end are optional arguments.

From the above syntax, you can observe that the .find() method takes the desired substring as the mandatory argument. You can specify the other two arguments: an inclusive starting position and an exclusive ending position.

Substring Search

In the example code, you search for Waldo in the string Where's Waldo?. The .find() method returns the lowest index in the string where it can find the substring, in this case, eight.

my_string = "Where's Waldo?"

If you search for Wenda, it returns -1 since the substring is not found.


Let's see if you can find Waldo between characters zero and five. In the code, you specify the starting position zero and ending position as six, since this position is not inclusive.

my_string = "Where's Waldo?"
my_string.find("Waldo", 0, 6)

The .find() method does not find the substring and returns -1, as shown above.

.index() Method


string.index(substring, start, end)

Note: start and end are optional arguments.

From the above syntax, you can observe that the .index() method takes the desired substring as a mandatory argument. It can take optional starting and ending positions as well.

Substring Search

In the example, we search again for Waldo using .index().

my_string = "Where's Waldo?"

We get eight again. When we look for a substring that is not there, we have a difference.

File "<stdin>", line 1, in <module>
ValueError: substring not found

The .index() method raises an exception, as we can see in the output. We can handle this using the try except block.

my_string = "Where's Waldo?"
except ValueError:
      print("Not found")

Above, you can observe the syntax. The try part will test the given code. If any error appears, the except part will be executed, obtaining the following output as a result.

"Not found"

.count() Method

The .count() method searches for a specified substring in the target string. It returns the number of non-overlapping occurrences. In simple words, how many times the substring is present in the string.


The syntax of .count() is very similar to the other methods, as we can observe.

string.count(substring, start, end)

Note: start and end are optional arguments.

Substring Count

In the example, we use the .count() method to get how many times fruit appears.

my_string = "How many fruits do you have in your fruit basket?"

In the output, we see that is is two.

We can then limit the occurrences of fruit between character zero and fifteen of the string, as we can observe in the code below.

my_string.count("fruit", 0, 16)

The method will return 1. Remember that the starting position is inclusive, but the ending is not.

.replace Method

Sometimes you will want to replace occurrences of a substring with a new substring. In this case, Python provides us with the .replace method.


string.replace(old, new, count)

Note: count is an optional argument.

As we see in the syntax above, it takes three arguments: the substring being replaced, the new string to replace it, and an optional number that indicates how many occurrences to replace.

Replacing a Substring

In the example code, we replace the substring house with car.

my_string = "The red house is between the blue house and the old house"
print(my_string.replace("house", "car"))
The red car is between the blue car and the old car

The method will return a copy with all house substrings replaced.

Replacing a Specific Number of Occurrences

In this example, we specified that we only want 2 of the occurrences to be replaced.

print(my_string.replace("house", "car", 2))
The red car is between the blue car and the old house

In the output, we see that the method returns a copy of the string with the first two occurrences of house replaced by car.

Interactive Example

In the below example, you will:

  • Find if the substring actor occurs between the characters with index 37 and 41 inclusive. If it is not detected, print the statement Word not found.
  • Replace actor actor with the substring actor if actor occurs only two repeated times.
  • Replace actor actor actor with the substring actor if actor appears three repeated times.
for movie in movies:
      # Find if actor occurrs between 37 and 41 inclusive
    if movie.find("actor", 37, 42) == -1:
        print("Word not found")
    # Count occurrences and replace two by one
    elif movie.count("actor") == 2:  
        print(movie.replace("actor actor", "actor"))
        # Replace three occurrences by one
        print(movie.replace("actor actor actor", "actor"))

When we run the above code, it produces the following result:

Word not found
I believe you I always said that the actor is amazing in every movie he has played
it's astonishing how frightening the actor norton looks with a shaved head and a swastika on his chest.

Try it for yourself.

To learn more about finding and replacing strings, please see this video from our course, Regular Expressions in Python.

This content is taken from DataCamp’s Regular Expressions in Python course by Maria Eugenia Inzaugarat.

Check out our Python String Tutorial.

Python Courses

Introduction to Python

BeginnerSkill Level
4 hr
Master the basics of data analysis with Python in just four hours. This online course will introduce the Python interface and explore popular packages.
See DetailsRight Arrow
Start Course
See MoreRight Arrow

10 Essential Python Skills All Data Scientists Should Master

All data scientists need expertise in Python, but which skills are the most important for them to master? Find out the ten most vital Python skills in the latest rundown.

Thaylise Nakamoto

9 min

The 7 Best Python Certifications For All Levels

Find out whether a Python certification is right for you, what the best options are, and the alternatives on offer in this comprehensive guide.
Matt Crabtree's photo

Matt Crabtree

18 min

A Complete Guide to Socket Programming in Python

Learn the fundamentals of socket programming in Python
Serhii Orlivskyi's photo

Serhii Orlivskyi

41 min

Textacy: An Introduction to Text Data Cleaning and Normalization in Python

Discover how Textacy, a Python library, simplifies text data preprocessing for machine learning. Learn about its unique features like character normalization and data masking, and see how it compares to other libraries like NLTK and spaCy.

Mustafa El-Dalil

5 min

Coding Best Practices and Guidelines for Better Code

Learn coding best practices to improve your programming skills. Explore coding guidelines for collaboration, code structure, efficiency, and more.
Amberle McKee's photo

Amberle McKee

26 min

Pandas Profiling (ydata-profiling) in Python: A Guide for Beginners

Learn how to use the ydata-profiling library in Python to generate detailed reports for datasets with many features.
Satyam Tripathi's photo

Satyam Tripathi

9 min

See MoreSee More