7.7. textwrap —Literals 换行和填充

2.3 版的新Function。

源代码： Lib/textwrap.py

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

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

有关wrap()行为的其他详细信息，请参见TextWrapper.wrap()方法。

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

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

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

最好将文本包装在空白处，并在连字符后的连字符后紧跟；只有这样，除非有必要，除非TextWrapper.break_long_words设置为 false，否则长单词将被打断。

提供了一个附加的 Util Functiondedent()，以从文本左侧带有多余空格的字符串中删除缩进。

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

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

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

For example:

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'

wrapper = TextWrapper(initial_indent="* ")

是相同的

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

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

TextWrapper实例属性(以及构造函数的关键字参数)如下：

Note

如果expand_tabs为 false 且replace_whitespace为 true，则每个制表符都将替换为一个空格，这与制表符 extensions*并非相同。

Note

如果replace_whitespace为假，则换行符可能会出现在一行的中间，并导致奇怪的输出。因此，应将文本拆分为段落(使用str.splitlines()或类似名称)，并分别包装。

2.6 版的新Function：在早期版本中始终删除空格。

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

和“现货”。在

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

fix_sentence_endings默认为假。

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

2.6 版的新Function。

TextWrapper还提供了两种公共方法，类似于模块级便捷Function：

首页