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