pandas.Series.str.wrap#

Series.str.обернуть(ширина, **kwargs)[источник]#

Перенос строк в Series/Index по указанной ширине строки.

Этот метод имеет те же ключевые параметры и значения по умолчанию, что и textwrap.TextWrapper.

Параметры:
ширинаint

Максимальная ширина строки.

expand_tabsbool, необязательно

Если True, символы табуляции будут преобразованы в пробелы (по умолчанию: True).

replace_whitespacebool, необязательно

Если True, каждый символ пробела (как определено string.whitespace), оставшийся после расширения табуляции, будет заменен одним пробелом (по умолчанию: True).

drop_whitespacebool, необязательно

Если True, пробелы, которые после переноса оказываются в начале или конце строки, удаляются (по умолчанию: True).

break_long_wordsbool, необязательно

Если True, то слова длиннее ширины будут разбиты, чтобы гарантировать, что ни одна строка не превышает ширину. Если False, длинные слова не будут разбиты, и некоторые строки могут быть длиннее ширины (по умолчанию: True).

break_on_hyphensbool, необязательно

Если True, перенос будет происходить предпочтительно на пробелах и сразу после дефисов в составных словах, как принято в английском языке. Если false, только пробелы будут рассматриваться как потенциально хорошие места для переноса строк, но необходимо установить break_long_words в false, если требуются действительно неразрывные слова (по умолчанию: True).

Возвращает:
Series или Index

Примечания

Внутренне этот метод использует textwrap.TextWrapper экземпляр с настройками по умолчанию. Для достижения поведения, соответствующего функции str_wrap библиотеки stringr в R, используйте аргументы:

  • 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