Content · Programming · Python

Python str.find Method: Usage and Examples

str.find(substring, start, end) searches for a substring and returns its first index, or -1 if it is absent. It is useful when a missing result is normal and should not raise an exception. Learn with a clear example.

2 views Published Oct 17, 2026 Updated Oct 18, 2026 Admin

This guide explains str.find Method: Usage and Examples through a focused example and practical reasoning. No prior knowledge of this specific operation is required.

Understanding the Concept


str.find(substring, start, end) searches for a substring and returns its first index, or -1 if it is absent. It is useful when a missing result is normal and should not raise an exception.

When You Would Use This


Locate the separator in a product reference before extracting the code.

Step-by-Step Example


product_reference = "ITEM-2048"
separator_position = product_reference.find("-")
print(separator_position)
print(product_reference.find("/"))

How the Example Works


The hyphen appears at index 4, while the slash is absent and produces -1. Avoid using find() results directly in a slice unless you have checked for -1.

Example Output


4
-1

Try It Yourself


Find the first @ in a sample email-like string and explain what happens when it is absent.

Common Beginner Mistakes


  • Treating a missing result of -1 as a valid character position.
  • Assuming find() returns a boolean.
  • Using find() for exact whole-word searches when substring matching is not sufficient.

Key Takeaways


  • str.find(substring, start, end) searches for a substring and returns its first index, or -1 if it is absent.
  • The hyphen appears at index 4, while the slash is absent and produces -1.
  • Avoid this mistake: Treating a missing result of -1 as a valid character position.
Share this resourceSend this page to someone who may find it useful.