Python String | find method
Start your free 7-days trial now!
Python's str.find(~)
method returns the index of the first occurrence of the specified substring in the source string.
Parameters
1. sub
| string
The substring to search for in source string.
2. start
| number
| optional
The index of the source string from which to start the search (inclusive). Defaults to 0
(start of source string).
3. end
| number
| optional
The index of the source string at which to end the search (exclusive). Defaults to len(source string) + 1
.
Return value
If substring is found, then the index of the first character of the substring in the source string is returned. If not found, then -1
is returned.
Examples
Basic usage
To obtain the starting index of the first occurrence of "bc"
:
w = "abcdbc"w.find("bc")
1
The first occurrence of "bc"
in "abcdbc"
occurs at index position 1
(after the 'a'
).
Substring not found
To obtain the starting index of the first occurrence of "gg"
:
x = "abcdbc"x.find("gg")
-1
As "gg"
was not found in "abcdbc"
, -1
is returned.
Start parameter
To start searching from index 2
(inclusive):
y = "abcdbc"y.find("bc", 2)
4
As the search starts from index position 2
(first 'c'
), the first occurrence of "bc"
is at index position 4
.
End parameter
To stop searching at index 3
(exclusive):
z = "abcdbc"z.find("cd", 3)
-1
As the search ends at and is exclusive of index position 3
('d'
), no occurrence of "cd"
is found and -1
is returned.