7.7. 文本换行 — 文字环绕和填充

2.3 版中的新功能。

源代码： :source:`Lib/textwrap.py`

textwrap 模块提供了两个方便的函数，wrap() 和 fill()，以及 TextWrapper，该类完成所有工作，以及一个实用函数 dedent()。如果你只是包装或填充一两个文本字符串，便利功能应该足够了；否则，您应该使用 TextWrapper 的实例以提高效率。

textwrap.wrap(text[, width[, ...]])

将单个段落包裹在 text（一个字符串）中，因此每行最多为 width 个字符长。返回输出行列表，没有最后的换行符。

可选的关键字参数对应于 TextWrapper 的实例属性，记录如下。 width 默认为 70。

有关 wrap() 行为的更多详细信息，请参阅 TextWrapper.wrap() 方法。

textwrap.fill(text[, width[, ...]])

将单个段落包装在 text 中，并返回包含包装段落的单个字符串。 fill() 是简写

"\n".join(wrap(text, ...))

特别是，fill() 接受与 wrap() 完全相同的关键字参数。

wrap() 和 fill() 通过创建一个 TextWrapper 实例并在其上调用一个方法来工作。该实例不会重用，因此对于包装/填充许多文本字符串的应用程序，创建自己的 TextWrapper 对象会更有效。

文本最好用空格包裹，并紧跟在带连字符的单词中的连字符之后；只有这样才会在必要时打破长字，除非 TextWrapper.break_long_words 设置为 false。

提供了一个额外的实用程序函数 dedent()，用于从文本左侧具有不需要的空白的字符串中删除缩进。

textwrap.dedent(text)

从 text 中的每一行删除任何常见的前导空格。

这可用于使三引号字符串与显示的左边缘对齐，同时仍以缩进形式在源代码中显示它们。

请注意，制表符和空格都被视为空格，但它们并不相等：行 " hello" 和 "\thello" 被认为没有共同的前导空格。（此行为在 Python 2.5 中是新的；此模块的旧版本在搜索常见的前导空格之前错误地扩展了选项卡。）

输入中仅包含空格的行将被忽略，并在输出中标准化为单个换行符。

例如：

def test():
    # end first line with \ to avoid the empty line!
    s = '''\
    hello
      world
    '''
    print repr(s)          # prints '    hello\n      world\n    '
    print repr(dedent(s))  # prints 'hello\n  world\n'

class textwrap.TextWrapper(...)

TextWrapper 构造函数接受许多可选的关键字参数。每个参数对应一个实例属性，例如

wrapper = TextWrapper(initial_indent="* ")

是相同的

wrapper = TextWrapper()
wrapper.initial_indent = "* "

您可以多次重复使用相同的 TextWrapper 对象，并且您可以通过在使用之间直接分配给实例属性来更改其任何选项。

TextWrapper 实例属性（和构造函数的关键字参数）如下：

width: （默认值：70）包裹线的最大长度。只要输入文本中没有长于 width 的单个单词，TextWrapper 保证没有输出行长于 width 个字符。

expand_tabs: （默认值：True）如果为真，则 text 中的所有制表符将使用 text 的 expandtabs() 方法扩展为空格。

replace_whitespace: （默认值：True）如果为真，则在制表符展开之后但换行之前，wrap() 方法将用单个空格替换每个空白字符。替换的空白字符如下：制表符、换行符、垂直制表符、换页符和回车符（'\t\n\v\f\r'）。

笔记

如果 expand_tabs 为假且 replace_whitespace 为真，则每个制表符将替换为单个空格，与制表符扩展相同不。

笔记

如果 replace_whitespace 为 false，换行符可能会出现在一行的中间并导致奇怪的输出。出于这个原因，文本应该被分成单独包装的段落（使用 str.splitlines() 或类似的）。

drop_whitespace: （默认值：True）如果为 true，则每行开头和结尾处的空格（换行后缩进前）将被删除。但是，如果后面有非空白，则不会删除段落开头的空白。如果删除的空格占据了整行，则整行都将被删除。

2.6 版新功能：在早期版本中总是删除空格。

initial_indent: （默认值：）将被添加到包装输出的第一行的字符串。计入第一行的长度。空字符串不缩进。

subsequent_indent: （默认值：）将被添加到除第一行之外的所有包装输出行的字符串。计入除第一行之外的每一行的长度。

fix_sentence_endings

（默认值：False）如果为真，TextWrapper 会尝试检测句子结尾并确保句子总是由两个空格分隔。这通常适用于等宽字体的文本。然而，句子检测算法并不完善：它假设句子结尾由一个小写字母组成，后跟 '.'、'!' 或 '?' 之一，可能后跟一个'"' 或 "'" 后跟一个空格。这个算法的一个问题是它无法检测“博士”之间的差异。在

[...] Dr. Frankenstein's monster [...]

和“现货”。在

[...] See Spot. See Spot run [...]

fix_sentence_endings 默认为 false。

由于句子检测算法依赖 string.lowercase 来定义“小写字母”，以及在句号后使用两个空格来分隔同一行句子的约定，因此它特定于英语文本。

break_long_words: （默认：True）如果为真，那么长于 width 的单词将被断开，以确保没有行长于 width。如果为false，长字不会断，有些行可能比width还长。（长字会自行排成一行，以尽量减少超出 width 的数量。）

break_on_hyphens: （默认值：True）如果为 true，则换行将优先出现在复合词中的空格和连字符之后，因为这是英语中的惯例。如果为 false，则只有空格会被视为可能适合换行的位置，但如果您想要真正不可分割的单词，则需要将 break_long_words 设置为 false。以前版本中的默认行为是始终允许断开带连字符的单词。

2.6 版中的新功能。

TextWrapper 还提供了两个公共方法，类似于模块级的便利函数：

wrap(text): 将单个段落包裹在 text（一个字符串）中，因此每行最多为 width 个字符长。所有包装选项均取自 TextWrapper 实例的实例属性。返回输出行列表，没有最后的换行符。如果包装的输出没有内容，则返回的列表为空。

fill(text): 将单个段落包装在 text 中，并返回包含包装段落的单个字符串。

7.7. textwrap — 文本换行和填充 — Python 文档

7.7. 文本换行 — 文字环绕和填充