pandas.Series.str.wrap

Series.str.wrap(width, **kwargs) [source]

Оборачивает длинные строки в Series/Index, чтобы отформатировать их в абзацы с длиной, меньшей заданной ширины.

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

Параметры:

width : int Максимальная ширина строки expand_tabs : bool, optional Если True, символы табуляции будут заменены пробелами (по умолчанию: True) replace_whitespace : bool, optional Если True, каждый символ пробела (как определено в string.whitespace), оставшийся после расширения табуляции, будет заменён одним пробелом (по умолчанию: True) drop_whitespace : bool, optional Если True, пробелы, которые после обрезки окажутся в начале или конце строки, будут удалены (по умолчанию: True) break_long_words : bool, optional Если True, слова, длиннее ширины, будут разбиты, чтобы гарантировать, что ни одна строка не будет длиннее ширины. Если False, длинные слова не будут разбиты, и некоторые строки могут быть длиннее ширины. (по умолчанию: True) break_on_hyphens : bool, optional Если True, обрезка будет происходить предпочтительно по пробелам и сразу после дефисов в составных словах, как это принято в английском языке. Если False, только пробелы будут рассматриваться как потенциальные места для разрыва строк, но необходимо установить break_long_words в значение false, если вы хотите, чтобы слова не разделялись. (по умолчанию: True)

Возвращает:

wrapped : Series/Index of objects

Примечания

Внутренне этот метод использует экземпляр 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