pandas.Series.isin

Series.isin(values)

判断 Series 中的元素是否包含在 values 中。

返回一个布尔 Series，显示 Series 中的每个元素是否与传入的 values 序列中的元素完全匹配。

Parameters:

valuesset 或类列表

要测试的值的序列。传递单个字符串将引发 TypeError。而是将单个字符串转换为包含一个元素的列表。

Returns:

Series

布尔 Series，指示每个元素是否在 values 中。

Raises:

TypeError

• 如果 values 是一个字符串

参见

DataFrame.isin

DataFrame 上的等效方法。

Examples

>>> s = pd.Series(['llama', 'cow', 'llama', 'beetle', 'llama',
...                'hippo'], name='animal')
>>> s.isin(['cow', 'llama'])
0     True
1     True
2     True
3    False
4     True
5    False
Name: animal, dtype: bool

要反转布尔值，请使用 ~ 运算符：

>>> ~s.isin(['cow', 'llama'])
0    False
1    False
2    False
3     True
4    False
5     True
Name: animal, dtype: bool

将单个字符串作为 s.isin('llama') 传递会引发错误。请改用包含一个元素的列表：

>>> s.isin(['llama'])
0     True
1    False
2     True
3    False
4     True
5    False
Name: animal, dtype: bool

字符串和整数是不同的，因此不具有可比性：

>>> pd.Series([1]).isin(['1'])
0    False
dtype: bool
>>> pd.Series([1.1]).isin(['1.1'])
0    False
dtype: bool