pandas.Series.str.startswith

Series.str.startswith(pat, na=_NoDefault.no_default)

测试每个字符串元素是否以某个模式开头。

等同于 str.startswith() 。

Parameters:

patstr 或 tuple[str, …]。

字符序列或字符串元组。不接受正则表达式。

nascalar, optional

当被测试的元素不是字符串时显示的对象。默认值取决于数组的 dtype。对于 object-dtype，使用 numpy.nan。对于可空的 StringDtype，使用 pandas.NA。对于 "str" dtype，使用 False。

Returns:

布尔值的 Series 或 Index。

一个布尔型的 Series，指示给定的模式是否匹配每个字符串元素的开头。

参见

str.startswith

Python 标准库字符串方法。

Series.str.endswith

与 startswith 相同，但测试字符串的结尾。

Series.str.contains

测试字符串元素是否包含某个模式。

Examples

>>> s = pd.Series(['bat', 'Bear', 'cat', np.nan])
>>> s
0     bat
1    Bear
2     cat
3     NaN
dtype: object

>>> s.str.startswith('b')
0     True
1    False
2    False
3      NaN
dtype: object

>>> s.str.startswith(('b', 'B'))
0     True
1     True
2    False
3      NaN
dtype: object

将 na 指定为 False 而不是 NaN。

>>> s.str.startswith('b', na=False)
0     True
1    False
2    False
3    False
dtype: bool