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, слова длиннее width будут разбиты, чтобы гарантировать, что ни одна строка не будет длиннее width. Если False, длинные слова не будут разбиваться, и некоторые строки могут быть длиннее width (по умолчанию: True).

break_on_hyphens:bool, optional

Если 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