Python输出格式化 格式化字符串语法
1.format
1.1 Format String Syntax
格式字符串语法 str.format()
方法和 Formatter 类共享相同的格式字符串语法(尽管在 Formatter 的情况下,子类可以定义自己的格式字符串语法)。 语法与格式化字符串文字的语法有关,但存在差异。
格式字符串包含用大括号 {}
包围的“替换字段”。 大括号中未包含的任何内容都被视为文字文本,将原样复制到输出中。 如果需要在文字文本中包含大括号字符,可以通过加倍转义:{
{
和 }}
。
替换字段的语法如下:
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
后跟可选的转换字段,前面是感叹号“!”
,和 format_spec
,前面是冒号“:”
。 这些指定替换值的非默认格式。
field_name
本身以一个 arg_name
开头,它可以是数字或关键字。 如果是数字,则表示位置参数,如果是关键字,则表示命名关键字参数。 如果格式字符串中的数字 arg_names
依次为 0, 1, 2, … ,它们都可以省略(不仅仅是一些),并且数字 0, 1, 2, … 将按该顺序自动插入。 由于 arg_name
不是引号分隔的,因此无法在格式字符串中指定任意字典键(例如,字符串'10'
或 ':-]'
)。 arg_name
后面可以跟任意数量的索引或属性表达式。 '.name'
形式的表达式使用 getattr()
选择命名属性,而'[index]'
形式的表达式使用__getitem__()
进行索引查找。
str.format()
可以省略位置参数说明符,因此'{}{}'.format(a, b)
等效于'{0} {1}'.format(a, b) )
。Formatter
可以省略位置参数说明符。
一些简单的格式字符串示例:
"First, thou shalt count to {0}" # 引用第一个位置参数
"Bring me a {}" # 隐式引用第一个位置参数
"From {} to {}" # 与“From {0} to {1}”相同
"My quest is {name}" # 引用关键字参数 'name'
"Weight in tons {0.weight}" # 第一个位置参数的“weight”属性
"Units destroyed: {players[0]}" # 关键字参数“players”的第一个元素。
>>> '{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'
>>> coord = (3, 5)
>>> 'X: {0[0]}; Y: {0[1]}'.format(coord)
'X: 3; Y: 5'
>>> c = 3-5j
>>> ('The complex number {0} is formed from the real part {0.real} and the imaginary part {0.imag}.').format(c