6.1. "string" --- 常见的字符串操作
**********************************

**源代码：** Lib/string.py

======================================================================

参见: 文本序列类型 --- str

  字符串的方法


6.1.1. 字符串常量
=================

此模块中定义的常量为：

string.ascii_letters

   下文所述 "ascii_lowercase" 和 "ascii_uppercase" 常量的拼连。 该值不
   依赖于语言区域。

string.ascii_lowercase

   小写字母 "'abcdefghijklmnopqrstuvwxyz'"。 该值不依赖于语言区域，不
   会发生改变。

string.ascii_uppercase

   大写字母 "'ABCDEFGHIJKLMNOPQRSTUVWXYZ'"。 该值不依赖于语言区域，不
   会发生改变。

string.digits

   字符串 "'0123456789'"。

string.hexdigits

   字符串 "'0123456789abcdefABCDEF'"。

string.octdigits

   字符串 "'01234567'"。

string.punctuation

   String of ASCII characters which are considered punctuation
   characters in the "C" locale.

string.printable

   由被视为可打印符号的 ASCII 字符组成的字符串。 这是 "digits",
   "ascii_letters", "punctuation" 和 "whitespace" 的总和。

string.whitespace

   由被视为空白符号的 ASCII 字符组成的字符串。 其中包括空格、制表、换
   行、回车、进纸和纵向制表符。


6.1.2. 自定义字符串格式化
=========================

内置的字符串类提供了通过使用 **PEP 3101** 所描述的 "format()" 方法进行
复杂变量替换和值格式化的能力。 "string" 模块中的 "Formatter" 类允许你
使用与内置 "format()" 方法相同的实现来创建并定制你自己的字符串格式化行
为。

class string.Formatter

   "Formatter" 类包含下列公有方法：

   format(format_string, *args, **kwargs)

      首要的 API 方法。 它接受一个格式字符串和任意一组位置和关键字参数
      。 它只是一个调用 "vformat()" 的包装器。

      3.5 版后已移除: Passing a format string as keyword argument
      *format_string* has been deprecated.

   vformat(format_string, args, kwargs)

      此函数执行实际的格式化操作。 它被公开为一个单独的函数，用于需要
      传入一个预定义字母作为参数，而不是使用 "*args" 和 "**kwargs" 语
      法将字典解包为多个单独参数并重打包的情况。 "vformat()" 完成将格
      式字符串分解为字符数据和替换字段的工作。 它会调用下文所述的几种
      不同方法。

   此外，"Formatter" 还定义了一些旨在被子类替换的方法：

   parse(format_string)

      循环遍历 format_string 并返回一个由可迭代对象组成的元组
      (*literal_text*, *field_name*, *format_spec*, *conversion*)。 它
      会被 "vformat()" 用来将字符串分解为文本字面值或替换字段。

      元组中的值在概念上表示一段字面文本加上一个替换字段。 如果没有字
      面文本（如果连续出现两个替换字段就会发生这种情况），则
      *literal_text* 将是一个长度为零的字符串。 如果没有替换字段，则
      *field_name*, *format_spec* 和 *conversion* 的值将为 "None"。

   get_field(field_name, args, kwargs)

      给定 *field_name* 作为 "parse()" (见上文) 的返回值，将其转换为要
      格式化的对象。 返回一个元组 (obj, used_key)。 默认版本接受在
      **PEP 3101** 所定义形式的字符串，例如 "0[name]" 或 "label.title"
      。 *args* 和 *kwargs* 与传给 "vformat()" 的一样。 返回值
      *used_key* 与 "get_value()" 的 *key* 形参具有相同的含义。

   get_value(key, args, kwargs)

      提取给定的字段值。 *key* 参数将为整数或字符串。 如果是整数，它表
      示 *args* 中位置参数的索引；如果是字符串，它表示 *kwargs* 中的关
      键字参数名。

      *args* 形参会被设为 "vformat()" 的位置参数列表，而 *kwargs* 形参
      会被设为由关键字参数组成的字典。

      For compound field names, these functions are only called for
      the first component of the field name; Subsequent components are
      handled through normal attribute and indexing operations.

      因此举例来说，字段表达式 '0.name' 将导致调用 "get_value()" 时附
      带 *key* 参数值 0。 在 "get_value()" 通过调用内置的 "getattr()"
      函数返回后将会查找 "name" 属性。

      如果索引或关键字引用了一个不存在的项，则将引发 "IndexError" 或
      "KeyError"。

   check_unused_args(used_args, args, kwargs)

      在必要时实现对未使用参数进行检测。 此函数的参数是是格式字符串中
      实际引用的所有参数键的集合（整数表示位置参数，字符串表示名称参数
      ），以及被传给 vformat 的 *args* 和 *kwargs* 的引用。 未使用参数
      的集合可以根据这些形参计算出来。 如果检测失败则
      "check_unused_args()" 应会引发一个异常。

   format_field(value, format_spec)

      "format_field()" 会简单地调用内置全局函数 "format()"。 提供该方
      法是为了让子类能够重载它。

   convert_field(value, conversion)

      使用给定的转换类型（来自 "parse()" 方法所返回的元组）来转换（由
      "get_field()" 所返回的）值。 默认版本支持 's' (str), 'r' (repr)
      和 'a' (ascii) 等转换类型。


6.1.3. 格式字符串语法
=====================

"str.format()" 方法和 "Formatter" 类共享相同的格式字符串语法（虽然对于
"Formatter" 来说，其子类可以定义它们自己的格式字符串语法）。 具体语法
与 格式化字符串字面值 相似，但也存在区别。

格式字符串包含有以花括号 "{}" 括起来的“替换字段”。 不在花括号之内的内
容被视为字面文本，会不加修改地复制到输出中。 如果你需要在字面文本中包
含花括号字符，可以通过重复来转义: "{{" and "}}"。

替换字段的语法如下：

      replacement_field ::= "{" [field_name] ["!" conversion] [":" format_spec] "}"
      field_name        ::= arg_name ("." attribute_name | "[" element_index "]")*
      arg_name          ::= [identifier | digit+]
      attribute_name    ::= identifier
      element_index     ::= digit+ | index_string
      index_string      ::= <any source character except "]"> +
      conversion        ::= "r" | "s" | "a"
      format_spec       ::= <described in the next section>

用不太正式的术语来描述，替换字段开头可以用一个 *field_name* 指定要对值
进行格式化并取代替换字符被插入到输出结果的对象。 *field_name* 之后有可
选的  *conversion* 字段，它是一个感叹号 "'!'" 加一个 *format_spec*，并
以一个冒号 "':'" 打头。 这些指明了替换值的非默认格式。

另请参阅 格式规格迷你语言 一节。

*field_name* 本身以一个数字或关键字 *arg_name* 打头。 如果为数字，则它
指向一个位置参数，而如果为关键字，则它指向一个命名关键字参数。 如果格
式字符串中的数字 arg_names 为 0, 1, 2, ... 的序列，它们可以全部省略（
而非部分省略），数字 0, 1, 2, ... 将会按顺序自动插入。 由于 *arg_name*
不使用引号分隔，因此无法在格式字符串中指定任意的字典键 (例如字符串
"'10'" 或 "':-]'")。 *arg_name* 之后可以带上任意数量的索引或属性表达式
。 "'.name'" 形式的表达式会使用 "getattr()" 选择命名属性，而
"'[index]'" 形式的表达式会使用 "__getitem__()" 执行索引查找。

在 3.1 版更改: 位置参数说明符对于 "str.format()" 可以省略，因此 "'{}
{}'.format(a, b)" 等价于 "'{0} {1}'.format(a, b)"。

在 3.4 版更改: 位置参数说明符对于 "Formatter" 可以省略。

一些简单的格式字符串示例

   "First, thou shalt count to {0}"  # References first positional argument
   "Bring me a {}"                   # Implicitly references the first positional argument
   "From {} to {}"                   # Same as "From {0} to {1}"
   "My quest is {name}"              # References keyword argument 'name'
   "Weight in tons {0.weight}"       # 'weight' attribute of first positional arg
   "Units destroyed: {players[0]}"   # First element of keyword argument 'players'.

使用 *conversion* 字段在格式化之前进行类型强制转换。 通常，格式化值的
工作由值本身的 "__format__()" 方法来完成。 但是，在某些情况下最好强制
将类型格式化为一个字符串，覆盖其本身的格式化定义。 通过在调用
"__format__()" 之前将值转换为字符串，可以绕过正常的格式化逻辑。

目前支持的转换旗标有三种: "'!s'" 会对值调用 "str()"，"'!r'" 调用
"repr()" 而 "'!a'" 则调用 "ascii()"。

几个例子：

   "Harold's a clever {0!s}"        # Calls str() on the argument first
   "Bring out the holy {name!r}"    # Calls repr() on the argument first
   "More {!a}"                      # Calls ascii() on the argument first

*format_spec* 字段包含值应如何呈现的规格描述，例如字段宽度、对齐、填充
、小数精度等细节信息。 每种值类型可以定义自己的“格式化迷你语言”或对
*format_spec* 的解读方式。

大多数内置类型都支持同样的格式化迷你语言，具体描述见下一节。

*format_spec* 字段还可以在其内部包含嵌套的替换字段。 这些嵌套的替换字
段可能包括字段名称、转换旗标和格式规格描述，但是不再允许更深层的嵌套。
format_spec 内部的替换字段会在解读 *format_spec* 字符串之前先被解读。
这将允许动态地指定特定值的格式。

请参阅 格式示例 一节查看相关示例。


6.1.3.1. 格式规格迷你语言
-------------------------

“格式规格”在格式字符串所包含的替换字段内部使用，用于定义单个值应如何呈
现 (参见 格式字符串语法 和 格式化字符串字面值)。 它们也可以被直接传给
内置的 "format()" 函数。 每种可格式化的类型都可以自行定义如何对格式规
格进行解读。

大多数内置类型都为格式规格实现了下列选项，不过某些格式化选项只被数值类
型所支持。

一般约定空格式字符串 ("""") 将产生与对值调用 "str()" 相同的结果。 非空
格式字符串通常会修改这一结果。

*标准格式说明符* 的一般形式如下：

   format_spec     ::= [[fill]align][sign][#][0][width][grouping_option][.precision][type]
   fill            ::= <any character>
   align           ::= "<" | ">" | "=" | "^"
   sign            ::= "+" | "-" | " "
   width           ::= digit+
   grouping_option ::= "_" | ","
   precision       ::= digit+
   type            ::= "b" | "c" | "d" | "e" | "E" | "f" | "F" | "g" | "G" | "n" | "o" | "s" | "x" | "X" | "%"

如果指定了一个有效的 *align* 值，则可以在该值前面加一个 *fill* 字符，
它可以为任意字符，如果省略则默认为空格符。 在 格式化字符串字面值 或在
使用 "str.format()" 方法时是无法使用花括号字面值 (""{"" or ""}"") 作为
*fill* 字符的。 但是，通过嵌套替换字段插入花括号则是可以的。 这个限制
不会影响 "format()" 函数。

各种对齐选项的含义如下：

   +-----------+------------------------------------------------------------+
   | 选项      | 意义                                                       |
   |===========|============================================================|
   | "'<'"     | 强制字段在可用空间内左对齐（这是大多数对象的默认值）。     |
   +-----------+------------------------------------------------------------+
   | "'>'"     | 强制字段在可用空间内右对齐（这是数字的默认值）。           |
   +-----------+------------------------------------------------------------+
   | "'='"     | 强制将填充放置在符号（如果有）之后但在数字之前。这用于以   |
   |           | “+000000120”形式打印字段。此对齐选项仅对数字类型有效。当   |
   |           | '0'紧接在字 段宽度之前时，它成为默认值。                   |
   +-----------+------------------------------------------------------------+
   | "'^'"     | 强制字段在可用空间内居中。                                 |
   +-----------+------------------------------------------------------------+

请注意，除非定义了最小字段宽度，否则字段宽度将始终与填充它的数据大小相
同，因此在这种情况下，对齐选项没有意义。

*sign* 选项仅对数字类型有效，可以是以下之一：

   +-----------+------------------------------------------------------------+
   | 选项      | 意义                                                       |
   |===========|============================================================|
   | "'+'"     | 表示标志应该用于正数和负数。                               |
   +-----------+------------------------------------------------------------+
   | "'-'"     | 表示标志应仅用于负数（这是默认行为）。                     |
   +-----------+------------------------------------------------------------+
   | space     | 表示应在正数上使用前导空格，在负数上使用减号。             |
   +-----------+------------------------------------------------------------+

"'#'" 选项可以让“替代形式”被用于转换。 替代形式可针对不同类型分别定义
。 此选项仅对整数、浮点、复数和 Decimal 类型有效。 对于整数类型，当使
用二进制、八进制或十六进制输出时，此选项会为输出值添加相应的 "'0b'",
"'0o'" 或 "'0x'" 前缀。 对于浮点数、复数和 Decimal 类型，替代形式会使
得转换结果总是包含小数点符号，即使其不带小数。 通常只有在带有小数的情
况下，此类转换的结果中才会出现小数点符号。 此外，对于 "'g'" 和 "'G'"
转换，末尾的零不会从结果中被移除。

"','" 选项表示使用逗号作为千位分隔符。 对于感应区域设置的分隔符，请改
用 "'n'" 整数表示类型。

在 3.1 版更改: 添加了 "','" 选项 (另请参阅 **PEP 378**)。

"'_'" 选项表示对浮点表示类型和整数表示类型 "'d'" 使用下划线作为千位分
隔符。 对于整数表示类型 "'b'", "'o'", "'x'" 和 "'X'"，将为每 4 个数位
插入一个下划线。 对于其他表示类型指定此选项则将导致错误。

在 3.6 版更改: 添加了 "'_'" 选项 (另请参阅 **PEP 515**)。

*width* 是一个定义最小字段宽度的十进制整数。 如果未指定，则字段宽度将
由内容确定。

当未显式给出对齐方式时，在 *width* 字段前加一个零 ("'0'") 字段将为数字
类型启用感知正负号的零填充。 这相当于设置 *fill* 字符为 "'0'" 且
*alignment* 类型为 "'='"。

*precision* 是一个十进制数字，表示对于以 "'f'" and "'F'" 格式化的浮点
数值要在小数点后显示多少个数位，或者对于以 "'g'" 或 "'G'" 格式化的浮点
数值要在小数点前后共显示多少个数位。 对于非数字类型，该字段表示最大字
段大小 —— 换句话说就是要使用多少个来自字段内容的字符。 对于整数值则不
允许使用 *precision*。

最后，*type* 确定了数据应如何呈现。

可用的字符串表示类型是：

   +-----------+------------------------------------------------------------+
   | 类型      | 意义                                                       |
   |===========|============================================================|
   | "'s'"     | 字符串格式。这是字符串的默认类型，可以省略。               |
   +-----------+------------------------------------------------------------+
   | None      | 和 "'s'" 一样。                                            |
   +-----------+------------------------------------------------------------+

可用的整数表示类型是：

   +-----------+------------------------------------------------------------+
   | 类型      | 意义                                                       |
   |===========|============================================================|
   | "'b'"     | 二进制格式。 输出以 2 为基数的数字。                       |
   +-----------+------------------------------------------------------------+
   | "'c'"     | 字符。在打印之前将整数转换为相应的unicode字符。            |
   +-----------+------------------------------------------------------------+
   | "'d'"     | 十进制整数。 输出以 10 为基数的数字。                      |
   +-----------+------------------------------------------------------------+
   | "'o'"     | 八进制格式。 输出以 8 为基数的数字。                       |
   +-----------+------------------------------------------------------------+
   | "'x'"     | 十六进制格式。 输出以 16 为基数的数字，使用小写字母表示 9  |
   |           | 以上的数 码。                                              |
   +-----------+------------------------------------------------------------+
   | "'X'"     | 十六进制格式。 输出以 16 为基数的数字，使用大写字母表示 9  |
   |           | 以上的数 码。                                              |
   +-----------+------------------------------------------------------------+
   | "'n'"     | 数字。 这与 "'d'" 相似，不同之处在于它会使用当前区域设置来 |
   |           | 插入适当 的数字分隔字符。                                  |
   +-----------+------------------------------------------------------------+
   | None      | 和 "'d'" 相同。                                            |
   +-----------+------------------------------------------------------------+

在上述的表示类型之外，整数还可以通过下列的浮点表示类型来格式化 (除了
"'n'" 和 "None")。 当这样做时，会在格式化之前使用 "float()" 将整数转换
为浮点数。

浮点数和小数值可用的表示类型有：

   +-----------+------------------------------------------------------------+
   | 类型      | 意义                                                       |
   |===========|============================================================|
   | "'e'"     | 指数表示。 以使用字母 'e' 来标示指数的科学计数法打印数字。 |
   |           | 默认的精 度为 "6"。                                        |
   +-----------+------------------------------------------------------------+
   | "'E'"     | 指数表示。 与 "'e'" 相似，不同之处在于它使用大写字母 'E'   |
   |           | 作为分隔字 符。                                            |
   +-----------+------------------------------------------------------------+
   | "'f'"     | 定点表示。 将数字显示为一个定点数。 默认的精确度为 "6"。   |
   +-----------+------------------------------------------------------------+
   | "'F'"     | 定点表示。 与 "'f'" 相似，但会将 "nan" 转为  "NAN" 并将    |
   |           | "inf" 转为 "INF"。                                         |
   +-----------+------------------------------------------------------------+
   | "'g'"     | 常规格式。 对于给定的精度 "p >= 1"，这会将数值舍入到 "p"   |
   |           | 位有效数字 ，再将结果以定点格式或科学计数法进行格式化，具  |
   |           | 体取决于其值的大小。  准确的规则如下：假设使用表示类型     |
   |           | "'e'" 和精度 "p-1" 进行格式化的结 果具有指数值 "exp"。 则  |
   |           | 如果 "-4 <= exp < p"，该数字将使用表示类型 "'f'" 和精度    |
   |           | "p-1-exp" 进行格式化。 否则的话，该数字将使用表示类型      |
   |           | "'e'" 和精度 "p-1" 进行格式化。 在两种情况下，都会从有效数 |
   |           | 字中移除 无意义的末尾零，如果小数点之后没有数字则小数点也  |
   |           | 会被移除。  正负无穷，正负零和 nan 会分别被格式化为 "inf", |
   |           | "-inf", "0", "-0" 和 "nan"，无论精度如何设定。  精度 "0"   |
   |           | 会被视为等同于精度 "1"。 默认精度为 "6"。                  |
   +-----------+------------------------------------------------------------+
   | "'G'"     | 常规格式。 类似于 "'g'"，不同之处在于当数值非常大时会切换  |
   |           | 为 "'E'"。 无穷与 NaN 也会表示为大写形式。                 |
   +-----------+------------------------------------------------------------+
   | "'n'"     | 数字。 这与 "'g'" 相似，不同之处在于它会使用当前区域设置来 |
   |           | 插入适当 的数字分隔字符。                                  |
   +-----------+------------------------------------------------------------+
   | "'%'"     | 百分比。 将数字乘以 100 并显示为定点 ("'f'") 格式，后面带  |
   |           | 一个百分号 。                                              |
   +-----------+------------------------------------------------------------+
   | None      | 类似于 "'g'"，不同之处在于当使用定点表示法时，小数点后将至 |
   |           | 少显示一 位。 默认精度与表示给定值所需的精度一样。 整体效  |
   |           | 果为与其他格式修饰 符所调整的 "str()" 输出保持一致。       |
   +-----------+------------------------------------------------------------+


6.1.3.2. 格式示例
-----------------

本节包含 "str.format()" 语法的示例以及与旧式 "%" 格式化的比较。

该语法在大多数情况下与旧式的 "%" 格式化类似，只是增加了 "{}" 和 ":" 来
取代 "%"。 例如，，"'%03.2f'" 可以被改写为 "'{:03.2f}'"。

新的格式语法还支持新增的不同选项，将在以下示例中说明。

按位置访问参数:

   >>> '{0}, {1}, {2}'.format('a', 'b', 'c')
   'a, b, c'
   >>> '{}, {}, {}'.format('a', 'b', 'c')  # 3.1+ only
   'a, b, c'
   >>> '{2}, {1}, {0}'.format('a', 'b', 'c')
   'c, b, a'
   >>> '{2}, {1}, {0}'.format(*'abc')      # unpacking argument sequence
   'c, b, a'
   >>> '{0}{1}{0}'.format('abra', 'cad')   # arguments' indices can be repeated
   'abracadabra'

按名称访问参数:

   >>> 'Coordinates: {latitude}, {longitude}'.format(latitude='37.24N', longitude='-115.81W')
   'Coordinates: 37.24N, -115.81W'
   >>> coord = {'latitude': '37.24N', 'longitude': '-115.81W'}
   >>> 'Coordinates: {latitude}, {longitude}'.format(**coord)
   'Coordinates: 37.24N, -115.81W'

访问参数的属性:

   >>> c = 3-5j
   >>> ('The complex number {0} is formed from the real part {0.real} '
   ...  'and the imaginary part {0.imag}.').format(c)
   'The complex number (3-5j) is formed from the real part 3.0 and the imaginary part -5.0.'
   >>> class Point:
   ...     def __init__(self, x, y):
   ...         self.x, self.y = x, y
   ...     def __str__(self):
   ...         return 'Point({self.x}, {self.y})'.format(self=self)
   ...
   >>> str(Point(4, 2))
   'Point(4, 2)'

访问参数的项:

   >>> coord = (3, 5)
   >>> 'X: {0[0]};  Y: {0[1]}'.format(coord)
   'X: 3;  Y: 5'

替代 "%s" 和 "%r":

   >>> "repr() shows quotes: {!r}; str() doesn't: {!s}".format('test1', 'test2')
   "repr() shows quotes: 'test1'; str() doesn't: test2"

对齐文本以及指定宽度:

   >>> '{:<30}'.format('left aligned')
   'left aligned                  '
   >>> '{:>30}'.format('right aligned')
   '                 right aligned'
   >>> '{:^30}'.format('centered')
   '           centered           '
   >>> '{:*^30}'.format('centered')  # use '*' as a fill char
   '***********centered***********'

替代 "%+f", "%-f" 和 "% f" 以及指定正负号:

   >>> '{:+f}; {:+f}'.format(3.14, -3.14)  # show it always
   '+3.140000; -3.140000'
   >>> '{: f}; {: f}'.format(3.14, -3.14)  # show a space for positive numbers
   ' 3.140000; -3.140000'
   >>> '{:-f}; {:-f}'.format(3.14, -3.14)  # show only the minus -- same as '{:f}; {:f}'
   '3.140000; -3.140000'

替代 "%x" 和 "%o" 以及转换基于不同进位制的值:

   >>> # format also supports binary numbers
   >>> "int: {0:d};  hex: {0:x};  oct: {0:o};  bin: {0:b}".format(42)
   'int: 42;  hex: 2a;  oct: 52;  bin: 101010'
   >>> # with 0x, 0o, or 0b as prefix:
   >>> "int: {0:d};  hex: {0:#x};  oct: {0:#o};  bin: {0:#b}".format(42)
   'int: 42;  hex: 0x2a;  oct: 0o52;  bin: 0b101010'

使用逗号作为千位分隔符:

   >>> '{:,}'.format(1234567890)
   '1,234,567,890'

表示为百分数:

   >>> points = 19
   >>> total = 22
   >>> 'Correct answers: {:.2%}'.format(points/total)
   'Correct answers: 86.36%'

使用特定类型的专属格式化:

   >>> import datetime
   >>> d = datetime.datetime(2010, 7, 4, 12, 15, 58)
   >>> '{:%Y-%m-%d %H:%M:%S}'.format(d)
   '2010-07-04 12:15:58'

嵌套参数以及更复杂的示例:

   >>> for align, text in zip('<^>', ['left', 'center', 'right']):
   ...     '{0:{fill}{align}16}'.format(text, fill=align, align=align)
   ...
   'left<<<<<<<<<<<<'
   '^^^^^center^^^^^'
   '>>>>>>>>>>>right'
   >>>
   >>> octets = [192, 168, 0, 1]
   >>> '{:02X}{:02X}{:02X}{:02X}'.format(*octets)
   'C0A80001'
   >>> int(_, 16)
   3232235521
   >>>
   >>> width = 5
   >>> for num in range(5,12): 
   ...     for base in 'dXob':
   ...         print('{0:{width}{base}}'.format(num, base=base, width=width), end=' ')
   ...     print()
   ...
       5     5     5   101
       6     6     6   110
       7     7     7   111
       8     8    10  1000
       9     9    11  1001
      10     A    12  1010
      11     B    13  1011


6.1.4. 模板字符串
=================

模板字符串提供了由 **PEP 292** 所描述的更简便的字符串替换方式。 模板字
符串的一个主要用例是文本国际化 (i18n)，因为在此场景下，更简单的语法和
功能使得文本翻译过程比使用 Python 的其他内置字符串格式化工具更为方便。
作为基于模板字符串构建以实现 i18n 的库的一个示例，请参看 flufl.i18n 包
。

模板字符串支持基于 "$" 的替换，使用以下规则：

* "$$" 为转义符号；它会被替换为单个的 "$"。

* "$identifier" 为替换占位符，它会匹配一个名为 ""identifier"" 的映射
  键 。 在默认情况下，""identifier"" 限制为任意 ASCII 字母数字（包括下
  划 线）组成的字符串，不区分大小写，以下划线或 ASCII 字母开头。 在
  "$" 字符之后的第一个非标识符字符将表明占位符的终结。

* "${identifier}" 等价于 "$identifier"。 当占位符之后紧跟着有效的但
  又 不是占位符一部分的标识符字符时需要使用，例如 ""${noun}ification""
  。

在字符串的其他位置出现 "$" 将导致引发 "ValueError"。

"string" 模块提供了实现这些规则的 "Template" 类。 "Template" 有下列方
法：

class string.Template(template)

   该构造器接受一个参数作为模板字符串。

   substitute(mapping, **kwds)

      执行模板替换，返回一个新字符串。 *mapping* 为任意字典类对象，其
      中的键将匹配模板中的占位符。 或者你也可以提供一组关键字参数，其
      中的关键字即对应占位符。 当同时给出 *mapping* 和 *kwds* 并且存在
      重复时，则以 *kwds* 中的占位符为优先。

   safe_substitute(mapping, **kwds)

      类似于 "substitute()"，不同之处是如果有占位符未在 *mapping* 和
      *kwds* 中找到，不是引发 "KeyError" 异常，而是将原始占位符不加修
      改地显示在结果字符串中。 另一个与 "substitute()" 的差异是任何在
      其他情况下出现的 "$" 将简单地返回 "$" 而不是引发 "ValueError"。

      此方法被认为“安全”，因为虽然仍有可能发生其他异常，但它总是尝试返
      回可用的字符串而不是引发一个异常。 从另一方面来说，
      "safe_substitute()" 也可能根本算不上安全，因为它将静默地忽略错误
      格式的模板，例如包含多余的分隔符、不成对的花括号或不是合法
      Python 标识符的占位符等等。

   "Template" 的实例还提供一个公有数据属性：

   template

      这是作为构造器的 *template* 参数被传入的对象。 一般来说，你不应
      该修改它，但并不强制要求只读访问。

以下是一个如何使用模版的示例：

   >>> from string import Template
   >>> s = Template('$who likes $what')
   >>> s.substitute(who='tim', what='kung pao')
   'tim likes kung pao'
   >>> d = dict(who='tim')
   >>> Template('Give $who $100').substitute(d)
   Traceback (most recent call last):
   ...
   ValueError: Invalid placeholder in string: line 1, col 11
   >>> Template('$who likes $what').substitute(d)
   Traceback (most recent call last):
   ...
   KeyError: 'what'
   >>> Template('$who likes $what').safe_substitute(d)
   'tim likes $what'

进阶用法：你可以派生 "Template" 的子类来自定义占位符语法、分隔符，或用
于解析模板字符串的整个正则表达式。 为此目的，你可以重载这些类属性：

* *delimiter* -- This is the literal string describing a placeholder
  introducing delimiter.  The default value is "$".  Note that this
  should *not* be a regular expression, as the implementation will
  call "re.escape()" on this string as needed.

* *idpattern* -- This is the regular expression describing the
  pattern for non-braced placeholders (the braces will be added
  automatically as appropriate). The default value is the regular
  expression "(?-i :[_a-zA-Z][_a-zA-Z0-9]*)".

  注解: Since default *flags* is "re.IGNORECASE", pattern "[a-z]"
    can match with some non-ASCII characters. That's why we use local
    "-i" flag here.While *flags* is kept to "re.IGNORECASE" for
    backward compatibility, you can override it to "0" or
    "re.IGNORECASE | re.ASCII" when subclassing.

* *flags* -- 将在编译用于识别替换内容的正则表达式被应用的正则表达式
  旗 标。 默认值为 "re.IGNORECASE"。 请注意 "re.VERBOSE" 总是会被加为
  旗标 ，因此自定义的 *idpattern* 必须遵循详细正则表达式的约定。

  3.2 新版功能.

作为另一种选项，你可以通过重载类属性 *pattern* 来提供整个正则表达式模
式。 如果你这样做，该值必须为一个具有四个命名捕获组的正则表达式对象。
这些捕获组对应于上面已经给出的规则，以及无效占位符的规则：

* *escaped* -- 这个组匹配转义序列，在默认模式中即 "$$"。

* *named* -- 这个组匹配不带花括号的占位符名称；它不应当包含捕获组中
  的 分隔符。

* *braced* -- 这个组匹配带有花括号的占位符名称；它不应当包含捕获组中
  的 分隔符或者花括号。

* *invalid* -- 这个组匹配任何其他分隔符模式（通常为单个分隔符），并
  且 它应当出现在正则表达式的末尾。


6.1.5. 辅助函数
===============

string.capwords(s, sep=None)

   使用 "str.split()" 将参数拆分为单词，使用 "str.capitalize()" 将单词
   转为大写形式，使用 "str.join()" 将大写的单词进行拼接。 如果可选的第
   二个参数 *sep* 被省略或为 "None"，则连续的空白字符会被替换为单个空
   格符并且开头和末尾的空白字符会被移除，否则 *sep* 会被用来拆分和拼接
   单词。
