pandas.Series.str.startswith#
- Series.str.startswith(pat, na=<no_default>)[source]#
Test if the start of each string element matches a pattern.
Equivalent to
str.startswith().- Parameters:
- patstr or tuple[str, …]
Character sequence or tuple of strings. Regular expressions are not accepted.
- nascalar, optional
Object shown if element tested is not a string. The default depends on dtype of the array. For the
"str"dtype,Falseis used. For object dtype,numpy.nanis used. For the nullableStringDtype,pandas.NAis used.
- Returns:
- Series or Index of bool
A Series of booleans indicating whether the given pattern matches the start of each string element.
See also
str.startswithPython standard library string method.
Series.str.endswithSame as startswith, but tests the end of string.
Series.str.containsTests if string element contains a pattern.
Examples
>>> s = pd.Series(["bat", "Bear", "cat", np.nan]) >>> s 0 bat 1 Bear 2 cat 3 NaN dtype: str
>>> s.str.startswith("b") 0 True 1 False 2 False 3 False dtype: bool
>>> s.str.startswith(("b", "B")) 0 True 1 True 2 False 3 False dtype: bool