Метод contains

Метод contains применяется к Series через аксессор str и проверяет, содержит ли каждая строка заданную подстроку или регулярное выражение. Результатом является Series с булевыми значениями True или False. Первым параметром передаётся искомая подстрока или шаблон, вторым можно управлять чувствительностью к регистру.

Синтаксис

ser.str.contains(pat[, case=True][, na=None][, regex=True])

Пример

Проверим, какие строки содержат подстроку 'bc':

import pandas as pd

ser = pd.Series(['abcde', 'bcde', 'cde', 'defg'])
res = ser.str.contains('bc')
print(res)

Результат выполнения кода:

0	 True
1	 True
2	False
3	False
dtype: bool

Пример

Проверим наличие подстроки без учёта регистра:

import pandas as pd

ser = pd.Series(['abcde', 'bcde', 'CDE', 'defg'])
res = ser.str.contains('cd', case=False)
print(res)

Результат выполнения кода:

0	 True
1	False
2	 True
3	False
dtype: bool

Пример

Используем регулярное выражение для поиска цифр:

import pandas as pd

ser = pd.Series(['user1', 'article', 'data2', 'file'])
res = ser.str.contains(r'\d', regex=True)
print(res)

Результат выполнения кода:

0	 True
1	False
2	 True
3	False
dtype: bool

Пример

Обработаем пропущенные значения с параметром na:

import pandas as pd

ser = pd.Series(['abcde', None, 'cde', 'defg'])
res = ser.str.contains('cd', na=False)
print(res)

Результат выполнения кода:

0	False
1	False
2	 True
3	False
dtype: bool

Смотрите также

метод match,
который проверяет соответствие началу строки
метод fullmatch,
который проверяет полное соответствие всей строки
метод startswith,
который проверяет начало строки
метод endswith,
который проверяет окончание строки