pandas.Series.str.rsplit

Series.str.rsplit(pat=None, n=- 1, expand=False)[source]

Разделение строк по заданному разделителю/демаркатору справа налево.

Разделяет строку в Series/Index с правого края по заданному разделителю.

Parameters

pat:строка, необязательно

Строка для разделения. Если не указано, разделение происходит по пробелам.

n:целое число, по умолчанию -1 (все)

Ограничение числа разделений в результате. None, 0 и -1 будут интерпретированы как возврат всех разделений.

expand:bool, по умолчанию False

Развернуть разделенные строки в отдельные столбцы.

• Если True, возвращает DataFrame/MultiIndex, расширяя размерность.

• Если False, возвращает Series/Index, содержащий списки строк.

Returns

Series, Index, DataFrame или MultiIndex

Тип соответствует вызывающему элементу, за исключением expand=True (см. Примечания).

См. также

Series.str.split

Разделение строк по заданному разделителю/демаркатору.

Series.str.rsplit

Разделение строки по заданному разделителю/демаркатору, начиная справа.

Series.str.join

Объединение списков, содержащихся в элементах Series/Index с указанным разделителем.

str.split

Стандартная библиотечная версия для split.

str.rsplit

Стандартная библиотечная версия для rsplit.

Примечания

Обработка ключевого слова n зависит от количества найденных разделений:

• Если найденных разделений > n, то берутся только первые n разделений.

• Если найденных разделений <= n, то берутся все разделения.

• Если для определенной строки количество найденных разделений < n, добавляется None для заполнения до n, если expand=True

Если используется expand=True, вызывающие элементы Series и Index соответственно возвращают объекты DataFrame и MultiIndex.

Примеры

>>> s = pd.Series(
...     [
...         "this is a regular sentence",
...         "https://docs.python.org/3/tutorial/index.html",
...         np.nan
...     ]
... )
>>> s
0                       this is a regular sentence
1    https://docs.python.org/3/tutorial/index.html
2                                              NaN
dtype: object

В режиме по умолчанию строка разделяется по пробелам.

>>> s.str.split()
0                   [this, is, a, regular, sentence]
1    [https://docs.python.org/3/tutorial/index.html]
2                                                NaN
dtype: object

Без параметра n результаты rsplit и split идентичны.

>>> s.str.rsplit()
0                   [this, is, a, regular, sentence]
1    [https://docs.python.org/3/tutorial/index.html]
2                                                NaN
dtype: object

Параметр n может использоваться для ограничения количества разделений по разделителю. Результаты split и rsplit отличаются.

>>> s.str.split(n=2)
0                     [this, is, a regular sentence]
1    [https://docs.python.org/3/tutorial/index.html]
2                                                NaN
dtype: object

>>> s.str.rsplit(n=2)
0                     [this is a, regular, sentence]
1    [https://docs.python.org/3/tutorial/index.html]
2                                                NaN
dtype: object

Параметр pat может использоваться для разделения по другим символам.

>>> s.str.split(pat="/")
0                         [this is a regular sentence]
1    [https:, , docs.python.org, 3, tutorial, index...
2                                                  NaN
dtype: object

При использовании expand=True, элементы разделения будут развернуты в отдельные столбцы. Если присутствует NaN, он распространяется по столбцам во время разделения.

>>> s.str.split(expand=True)
                                               0     1     2        3         4
0                                           this    is     a  regular  sentence
1  https://docs.python.org/3/tutorial/index.html  None  None     None      None
2                                            NaN   NaN   NaN      NaN       NaN

Для более сложных случаев, таких как разделение имени html-документа из url, можно использовать комбинацию параметров.

>>> s.str.rsplit("/", n=1, expand=True)
                                    0           1
0          this is a regular sentence        None
1  https://docs.python.org/3/tutorial  index.html
2                                 NaN         NaN