dask.dataframe.Series.str.wrap

dask.dataframe.Series.str.wrap

dataframe.Series.str.wrap(width: int, **kwargs)

在指定的行宽处对 Series/Index 中的字符串进行换行。

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

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

此方法具有与 textwrap.TextWrapper 相同的键参数和默认值。

参数
宽度整数

最大行宽。

expand_tabsbool, 可选

如果为 True,制表符将被扩展为空格(默认:True)。

替换空白bool, 可选

如果为 True,每个在制表符扩展后剩余的空白字符(由 string.whitespace 定义)将被替换为一个空格(默认:True)。

drop_whitespacebool, 可选

如果为 True,在换行后偶然出现在行首或行尾的空白字符将被删除(默认值:True)。

break_long_wordsbool, 可选

如果为 True,那么长度超过宽度的单词将被拆分,以确保没有行超过指定的宽度。如果为 False,长单词将不会被拆分,并且某些行可能会超过指定的宽度(默认:True)。

break_on_hyphensbool, 可选

如果为 True,换行将优先在空白处和复合词中的连字符后发生,这是英语中的习惯做法。如果为 False,则只考虑空白处作为潜在的换行位置,但如果你想要真正不可分割的单词,你需要将 break_long_words 设置为 False(默认:True)。

返回
系列或索引

注释

在内部,此方法使用一个带有默认设置的 textwrap.TextWrapper 实例。要实现与 R 的 stringr 库 str_wrap 函数相匹配的行为,请使用以下参数:

  • expand_tabs = False

  • replace_whitespace = True

  • drop_whitespace = True

  • break_long_words = False

  • break_on_hyphens = False

示例

>>> s = pd.Series(['line to be wrapped', 'another line to be wrapped'])  
>>> s.str.wrap(12)  
0             line to be\nwrapped
1    another line\nto be\nwrapped
dtype: object