Python 3标准库课件第一章

第一章

文本处理工具：str类

string.Template 简便的方法来构建比str对象特性更丰富的字符串。

Web框架定义的模板或Python Package Index提供的扩展模块相比，尽管string.Template没有那么丰富的特性，但它确实能很好地支持用户可修改的模板，这些模板需要将动态值插入到静态文本中。

textwrap模块包含格式化段落文本的工具，可以限制输出的宽度、增加缩进，以及插入换行符从而能一致地自动换行。

1.1 string：文本常量和模板

string模块在最早的Python版本中就已经有了。以前这个模块中提供的很多函数已经移植为str对象的方法，不过这个模块仍保留了很多有用的常量和类来处理str对象。这里将重点讨论这些常量和类。
?
1.1.1?函数
??? 函数capwords()会把一个字符串中的所有单词首字母大写。
???????代码清单 1-1：string_capwords.py
???????--------------------------------
???????import string

???????s = ‘The quick brown fox jumped over the lazy dog.‘
???????print(s)
???????print(string.capwords(s))
???????--------------------------------
???????结果：
???????The quick brown fox jumped over the lazy dog.
???????The Quick Brown Fox Jumped Over The Lazy Dog.
------------------------------------------
这个代码的结果等同于先调用split()，把结果列表中的单词首字母大写，然后调用join()来合并结果。

1.1.2?模板

字符串模板是PEP 292新增的部分，将作为内置拼接语法的代替做法。使用string.Template拼接时，要在名字前面加前缀$来标识变量(例如，$var)。或者，如果有必要区分变量和周围的文本，可以用大括号
包围变量(例如，${var})。
下面这个例子对一个简单模板，使用%操作符的类似字符串拼接以及使用str.format()的新格式化字符串语法做了比较：
string.Template

???????代码清单1-2:string_template.py
???????------------------------------
???????import string

???????values = {‘var‘: ‘foo‘}
???????
???????t = string.Template("""
???????Variable? :$var
???????Escape??? :$$
???????Variable in text :${var}iable
???????"""
???????)
???????
???????print(‘TEMPLATE:‘,t.substitute(values))
???????
???????s = """
???????Variable? :%(var)s
???????Escape? :%%
???????Variable in text :%(var)siable???????
???????"""
???????
???????print(‘INTERPOLATION‘,s % values)
???????
???????s = """
???????Variable? : %{var}
???????Escape??? : {{}}
???????Variable in text :{var}siable
???????"""
???????
???????print(‘FORMAT:‘,s.format(**values))
???????-----------------------------------
在前面两种情况中，触发字符($或%)要重复两次来进行转义。在格式化语法中，需要重复{和}来转义。
-----------------------------------------------
TEMPLATE:
Variable? :foo
Escape??? :$
Variable in text :fooiable

INTERPOLATION
Variable? :foo
Escape? :%
Variable in text :fooiable???????

FORMAT:
Variable? : %foo
Escape??? : {}
Variable in text :foosiable
-------------------------------------------------
模板与字符串拼接或格式化的一个关键区别是，它不考虑参数的类型。值会转换为字符串，再将字符串插入结果。这里没有提供格式化选项。例如，没有办法控制使用几位有效数字来表示一个浮点值。
不过，这也有一个好处，通过使用sfe_substitute()方法，可以避免未能向模板提供所需的所有参数值时可能产生的异常。
-------------------------------------------------
???????代码清单1-3：string_template_missing.py
???????---------------------------------------
???????import string

???????values = {‘var‘: ‘foo‘}
???????
???????t = string.Template("$var is here but $missing is not provided")
???????
???????try:
????????print(‘substitute()? :‘,t.substitute(values))
???????except KeyError as err:
????????print(‘ERROR:‘,str(err))
????????
???????print(‘safe_substitute():‘,t.safe_substitute(values))
???????---------------------------------------
???????结果：
???????ERROR: ‘missing‘
???????safe_substitute(): foo is here but $missing is not provided
???????---------------------------------------
由于values字典中没有missing的值，所以substitute()会产生一个KeyError。safe_substitute()则不同，它不会抛出这个错误，而是会捕获这个错误并保留文本中的变量表达式。

1.1.3 高级模板
可以调整string.Template在模板体中查找变量名所使用的正则表达式模式，以改变它的默认语法。为此，一种简单的方法是修改delimiter和idpattern类属性。
???????代码清单1-4：string_template_advanced.py
???????-----------------------------------------
???????import string

???????class MyTemplate(string.Template):
????????delimiter = ‘%‘
????????idpattern = ‘[a-z]+_[a-z]+‘
????????
???????template_text = ‘‘‘
???????Delimiter : %%
???????Replaced? : %with_underscore
???????Ignored?? : %notunderscored
???????‘‘‘
???????
???????d = {
????????‘with_underscore‘: ‘replaced‘,
????????‘notunderscored‘:? ‘not replaced‘,
???????}
???????
???????t = MyTemplate(template_text)
???????print(‘Modified ID pattern: ‘)
???????print(t.safe_substitute(d))
???????------------------------------------------
???????Modified ID pattern:

???????Delimiter : % ???????Replaced? : replaced ???????Ignored?? : %notunderscored ???????------------------------------------------ ???????