dask.dataframe.Series.str.rsplit

dask.dataframe.Series.str.rsplit

dataframe.Series.str.rsplit(pat=None, n=- 1, expand=False)

根据给定的分隔符/定界符拆分字符串。

此文档字符串是从 pandas.core.strings.accessor.StringMethods.rsplit 复制而来的。

Dask 版本可能存在一些不一致性。

从指定分隔符字符串的末尾开始,将Series/Index中的字符串分割。

参数
patstr, 可选

要分割的字符串。如果未指定,则按空白字符分割。

nint, 默认 -1 (全部)

限制输出中的分割数量。None、0 和 -1 将被解释为返回所有分割。

展开bool, 默认 False

将分割的字符串扩展为单独的列。

  • 如果 True,返回扩展维度的 DataFrame/MultiIndex。

  • 如果 False,返回 Series/Index,包含字符串列表。

返回
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,如果 expand=True,则追加 None 以填充至 n

如果使用 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 参数,rsplitsplit 的输出是相同的。

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

n 参数可以用来限制在分隔符上的分割次数。splitrsplit 的输出是不同的。

>>> 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