/usr/share/doc/diveintopython-zh/html/html_processing/dictionary_based_string_formatting.html is in diveintopython-zh 5.4b-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 | <!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>8.6. 基于 dictionary 的字符串格式化</title>
<link rel="stylesheet" href="../diveintopython.css" type="text/css">
<link rev="made" href="mailto:f8dy@diveintopython.org">
<meta name="generator" content="DocBook XSL Stylesheets V1.52.2">
<meta name="keywords" content="Python, Dive Into Python, tutorial, object-oriented, programming, documentation, book, free">
<meta name="description" content="Python from novice to pro">
<link rel="home" href="../toc/index.html" title="Dive Into Python">
<link rel="up" href="index.html" title="第 8 章 HTML 处理">
<link rel="previous" href="locals_and_globals.html" title="8.5. locals 和 globals">
<link rel="next" href="quoting_attribute_values.html" title="8.7. 给属性值加引号">
</head>
<body>
<table id="Header" width="100%" border="0" cellpadding="0" cellspacing="0" summary="">
<tr>
<td id="breadcrumb" colspan="5" align="left" valign="top">导航：<a href="../index.html">起始页</a> > <a href="../toc/index.html">Dive Into Python</a> > <a href="index.html">HTML 处理</a> > <span class="thispage">基于 dictionary 的字符串格式化</span></td>
<td id="navigation" align="right" valign="top"> <a href="locals_and_globals.html" title="上一页: “locals 和 globals”"><<</a> <a href="quoting_attribute_values.html" title="下一页: “给属性值加引号”">>></a></td>
</tr>
<tr>
<td colspan="3" id="logocontainer">
<h1 id="logo"><a href="../index.html" accesskey="1">深入 Python :Dive Into Python 中文版</a></h1>
<p id="tagline">Python 从新手到专家 [Dip_5.4b_CPyUG_Release]</p>
</td>
<td colspan="3" align="right">
<form id="search" method="GET" action="http://www.google.com/custom">
<p><label for="q" accesskey="4">Find: </label><input type="text" id="q" name="q" size="20" maxlength="255" value=""> <input type="submit" value="搜索"><input type="hidden" name="domains" value="woodpecker.org.cn"><input type="hidden" name="sitesearch" value="www.woodpecker.org.cn/diveintopython"></p>
</form>
</td>
</tr>
</table>
<!--#include virtual="/inc/ads" -->
<div class="section" lang="zh_cn">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a name="dialect.dictsub"></a>8.6. 基于 dictionary 的字符串格式化
</h2>
</div>
</div>
<div></div>
</div>
<p>为什么学习 <tt class="function">locals</tt> 和 <tt class="function">globals</tt>？因为接下来就可以学习关于基于 dictionary 的字符串格式化。或许您还能记起，<a href="../native_data_types/formatting_strings.html" title="3.5. 格式化字符串">字符串格式化</a>提供了一种将值插入字符串中的一种便捷的方法。值被列在一个 tuple 中，按照顺序插入到字符串中每个格式化标记所在的位置上。尽管这种做法效率高，但还不是最容易阅读的代码，特别是当插入多个值的时候。仅用眼看一遍字符串，您不能马上就明白结果是什么；您需要经常地在字符串和值的
tuple 之间进行反复查看。
</p>
<div class="abstract">
<p>有另外一种字符串格式化的形式，它使用 dictionary 而不是值的 tuple。</p>
</div>
<div class="example"><a name="d0e21670"></a><h3 class="title">例 8.13. 基于 dictionary 的字符串格式化介绍</h3><pre class="screen">
<tt class="prompt">>>> </tt><span class="userinput">params = {<span class='pystring'>"server"</span>:<span class='pystring'>"mpilgrim"</span>, <span class='pystring'>"database"</span>:<span class='pystring'>"master"</span>, <span class='pystring'>"uid"</span>:<span class='pystring'>"sa"</span>, <span class='pystring'>"pwd"</span>:<span class='pystring'>"secret"</span>}</span>
<tt class="prompt">>>> </tt><span class="userinput"><span class='pystring'>"%(pwd)s"</span> % params</span> <a name="dialect.dictsub.1.1"></a><img src="../images/callouts/1.png" alt="1" border="0" width="12" height="12">
<span class="computeroutput">'secret'</span>
<tt class="prompt">>>> </tt><span class="userinput"><span class='pystring'>"%(pwd)s is not a good password for %(uid)s"</span> % params</span> <a name="dialect.dictsub.1.2"></a><img src="../images/callouts/2.png" alt="2" border="0" width="12" height="12">
<span class="computeroutput">'secret is not a good password for sa'</span>
<tt class="prompt">>>> </tt><span class="userinput"><span class='pystring'>"%(database)s of mind, %(database)s of body"</span> % params</span> <a name="dialect.dictsub.1.3"></a><img src="../images/callouts/3.png" alt="3" border="0" width="12" height="12">
<span class="computeroutput">'master of mind, master of body'</span></pre><div class="calloutlist">
<table border="0" summary="Callout list">
<tr>
<td width="12" valign="top" align="left"><a href="#dialect.dictsub.1.1"><img src="../images/callouts/1.png" alt="1" border="0" width="12" height="12"></a>
</td>
<td valign="top" align="left">这种字符串格式化形式不用显式的值的 tuple，而是使用一个 dictionary，<tt class="varname">params</tt>。并且标记也不是在字符串中的一个简单 <tt class="literal">%s</tt>，而是包含了一个用括号包围起来的名字。这个名字是 <tt class="varname">params</tt> dictionary 中的一个键字，所以 <tt class="literal">%(pwd)s</tt> 标记被替换成相应的值 <tt class="literal">secret</tt>。
</td>
</tr>
<tr>
<td width="12" valign="top" align="left"><a href="#dialect.dictsub.1.2"><img src="../images/callouts/2.png" alt="2" border="0" width="12" height="12"></a>
</td>
<td valign="top" align="left">基于 dictionary 的字符串格式化可用于任意数量的有名的键字。每个键字必须在一个给定的 dictionary 中存在，否则这个格式化操作将失败并引发一个 <tt class="errorcode">KeyError</tt> 的异常。
</td>
</tr>
<tr>
<td width="12" valign="top" align="left"><a href="#dialect.dictsub.1.3"><img src="../images/callouts/3.png" alt="3" border="0" width="12" height="12"></a>
</td>
<td valign="top" align="left">您甚至可以两次指定同一键字，每个键字出现之处将被同一个值所替换。</td>
</tr>
</table>
</div>
</div>
<p>那么为什么您偏要使用基于 dictionary 的字符串格式化呢？的确，仅为了进行字符串格式化，就事先创建一个有键字和值的 dictionary 看上去的确有些小题大作。它的真正最大用处是当您碰巧已经有了像 <a href="locals_and_globals.html" title="8.5. locals 和 globals"><tt class="function">locals</tt></a> 一样的有意义的键字和值的 dictionary 的时候。
</p>
<div class="example"><a name="dialect.unknownstarttag"></a><h3 class="title">例 8.14. <tt class="filename">BaseHTMLProcessor.py</tt> 中的基于 dictionary 的字符串格式化
</h3><pre class="programlisting">
<span class='pykeyword'>def</span><span class='pyclass'> handle_comment</span>(self, text):
self.pieces.append(<span class='pystring'>"<!--%(text)s-->"</span> % locals()) <a name="dialect.dictsub.2.1"></a><img src="../images/callouts/1.png" alt="1" border="0" width="12" height="12">
</pre><div class="calloutlist">
<table border="0" summary="Callout list">
<tr>
<td width="12" valign="top" align="left"><a href="#dialect.dictsub.2.1"><img src="../images/callouts/1.png" alt="1" border="0" width="12" height="12"></a>
</td>
<td valign="top" align="left">使用内置的 <tt class="function">locals</tt> 函数是最普通的基于 dictionary 的字符串格式化的应用。这就是说您可以在您的字符串 (本例中是 <tt class="varname">text</tt>，它作为一个参数传递给类方法) 中使用局部变量的名字，并且每个命名的变量将会被它的值替换。如果 <tt class="varname">text</tt> 是 <tt class="literal">'Begin page footer'</tt>，字符串格式化 <tt class="literal">"<!--%(text)s-->" % locals()</tt> 将得到字符串 <tt class="literal">'<!--Begin page footer-->'</tt>。
</td>
</tr>
</table>
</div>
</div>
<div class="example"><a name="d0e21774"></a><h3 class="title">例 8.15. 基于 dictionary 的字符串格式化的更多内容</h3><pre class="programlisting">
<span class='pykeyword'>def</span><span class='pyclass'> unknown_starttag</span>(self, tag, attrs):
strattrs = <span class='pystring'>""</span>.join([<span class='pystring'>' %s="%s"'</span> % (key, value) <span class='pykeyword'>for</span> key, value <span class='pykeyword'>in</span> attrs]) <a name="dialect.dictsub.3.1"></a><img src="../images/callouts/1.png" alt="1" border="0" width="12" height="12">
self.pieces.append(<span class='pystring'>"<%(tag)s%(strattrs)s>"</span> % locals()) <a name="dialect.dictsub.3.2"></a><img src="../images/callouts/2.png" alt="2" border="0" width="12" height="12">
</pre><div class="calloutlist">
<table border="0" summary="Callout list">
<tr>
<td width="12" valign="top" align="left"><a href="#dialect.dictsub.3.1"><img src="../images/callouts/1.png" alt="1" border="0" width="12" height="12"></a>
</td>
<td valign="top" align="left">当这个模块被调用时，<tt class="varname">attrs</tt> 是一个键/值 tuple 的 list，就像一个 <a href="../native_data_types/mapping_lists.html#odbchelper.items" title="例 3.25. keys, values 和 items 函数">dictionary 的 <tt class="function">items</tt></a>。这就意味着我们可以使用<a href="../native_data_types/declaring_variables.html#odbchelper.multiassign" title="3.4.2. 一次赋多值">多变量赋值</a>来遍历它。到现在这将是一种熟悉的模式，但是这里有很多东西，让我们分开来看：
<div class="orderedlist">
<ol type="a">
<li>假设 <tt class="varname">attrs</tt> 是 <tt class="literal">[('href', 'index.html'), ('title', 'Go to home page')]</tt>。
</li>
<li>在这个列表解析的第一轮循环中，<tt class="varname">key</tt> 将为 <tt class="literal">'href'</tt>，<tt class="varname">value</tt> 将为 <tt class="literal">'index.html'</tt>。
</li>
<li>字符串格式化 <tt class="literal">' %s="%s"' % (key, value)</tt> 将生成 <tt class="literal">' href="index.html"'</tt>。这个字符串就作为这个列表解析返回值的第一个元素。
</li>
<li>在第二轮中，<tt class="varname">key</tt> 将为 <tt class="literal">'title'</tt>，<tt class="varname">value</tt> 将为 <tt class="literal">'Go to home page'</tt>。
</li>
<li>字符串格式化将生成 <tt class="literal">' title="Go to home page"'</tt>。
</li>
<li>这个 list 理解返回两个生成的字符串 list，并且 <tt class="varname">strattrs</tt> 将把这个 list 的两个元素连接在一起形成 <tt class="literal">' href="index.html" title="Go to home page"'</tt>。
</li>
</ol>
</div>
</td>
</tr>
<tr>
<td width="12" valign="top" align="left"><a href="#dialect.dictsub.3.2"><img src="../images/callouts/2.png" alt="2" border="0" width="12" height="12"></a>
</td>
<td valign="top" align="left">现在，使用基于 dictionary 的字符串格式化，我们将 <tt class="varname">tag</tt> 和 <tt class="varname">strattrs</tt> 的值插入到一个字符串中。所以，如果 <tt class="varname">tag</tt> 是 <tt class="literal">'a'</tt>，最终的结果会是 <tt class="literal">'<a href="index.html" title="Go to home page">'</tt>，并且这就是追加到 <tt class="varname">self.pieces</tt> 后面的东西。
</td>
</tr>
</table>
</div>
</div><a name="d0e21883"></a><table class="important" border="0" summary="">
<tr>
<td rowspan="2" align="center" valign="top" width="1%"><img src="../images/important.png" alt="重要" title="" width="24" height="24"></td>
</tr>
<tr>
<td colspan="2" align="left" valign="top" width="99%">使用 <tt class="function">locals</tt> 来应用基于 dictionary 的字符串格式化是一种方便的作法，它可以使复杂的字符串格式化表达式更易读。但它需要花费一定的代价。在调用 <tt class="function">locals</tt> 方面有一点性能上的问题，这是由于 <a href="locals_and_globals.html#dialect.locals.readonly.example" title="例 8.12. locals 是只读的，globals 不是"> <tt class="function">locals</tt> 创建了局部名字空间的一个拷贝</a>引起的。
</td>
</tr>
</table>
</div>
<table class="Footer" width="100%" border="0" cellpadding="0" cellspacing="0" summary="">
<tr>
<td width="35%" align="left"><br><a class="NavigationArrow" href="locals_and_globals.html"><< locals 和 globals</a></td>
<td width="30%" align="center"><br> <span class="divider">|</span> <a href="index.html#dialect.divein" title="8.1. 概览">1</a> <span class="divider">|</span> <a href="introducing_sgmllib.html" title="8.2. sgmllib.py 介绍">2</a> <span class="divider">|</span> <a href="extracting_data.html" title="8.3. 从 HTML 文档中提取数据">3</a> <span class="divider">|</span> <a href="basehtmlprocessor.html" title="8.4. BaseHTMLProcessor.py 介绍">4</a> <span class="divider">|</span> <a href="locals_and_globals.html" title="8.5. locals 和 globals">5</a> <span class="divider">|</span> <span class="thispage">6</span> <span class="divider">|</span> <a href="quoting_attribute_values.html" title="8.7. 给属性值加引号">7</a> <span class="divider">|</span> <a href="dialect.html" title="8.8. dialect.py 介绍">8</a> <span class="divider">|</span> <a href="all_together.html" title="8.9. 全部放在一起">9</a> <span class="divider">|</span> <a href="summary.html" title="8.10. 小结">10</a> <span class="divider">|</span>
</td>
<td width="35%" align="right"><br><a class="NavigationArrow" href="quoting_attribute_values.html">给属性值加引号 >></a></td>
</tr>
<tr>
<td colspan="3"><br></td>
</tr>
</table>
<div class="Footer">
<p class="copyright">Copyright © 2000, 2001, 2002, 2003, 2004 <a href="mailto:mark@diveintopython.org">Mark Pilgrim</a></p>
<p class="copyright">Copyright © 2001, 2002, 2003, 2004, 2005, 2006, 2007 <a href="mailto:python-cn@googlegroups.com">CPyUG (邮件列表)</a></p>
</div>
</body>
</html>
|