19.13. xml.sax.saxutils — SAX 工具集

2.0 新版功能.

xml.sax.saxutils 模块包含一些在创建 SAX 应用程序时十分有用的类和函数，它们可以被直接使用，或者是作为基类使用。

xml.sax.saxutils.escape(data[, entities])

对数据字符串中对 '&', '<' 和 '>' 进行转义。

你可以通过传入一个字典作为可选的 entities 形参来对其他字符串数据进行转义。 字典的键和值必须为字符串；每个键将被替换为其所对应的值。 字符 '&', '<' 和 '>' 总是会被转义，即使提供了 entities。

xml.sax.saxutils.unescape(data[, entities])

对字符串数据中的 '&amp;', '&lt;' 和 '&gt;' 进行反转义。

你可以通过传入一个字典作为可选的 entities 形参来对其他数据字符串进行转义。 字典的键和值必须都为字符串；每个键将被替换为所对应的值。 '&amp', '&lt;' 和 '&gt;' 将总是保持不被转义，即使提供了 entities。

2.3 新版功能.

xml.sax.saxutils.quoteattr(data[, entities])

类似于 escape()，但还会对 data 进行处理以将其用作属性值。 返回值是 data 加上任何额外要求的替换的带引号版本。quoteattr() 将基于 data 的内容选择一个引号字符，以尽量避免在字符串中编码任何引号字符。 如果单双引号字符在 data 中都存在，则双引号字符将被编码并且 data 将使用双引号来标记。 结果字符串可被直接用作属性值:

>>> print "<element attr=%s>" % quoteattr("ab ' cd \" ef")
<element attr="ab ' cd &quot; ef">

此函数适用于为 HTML 或任何使用引用实体语法的 SGML 生成属性值。

2.2 新版功能.

class xml.sax.saxutils.XMLGenerator([out[, encoding]])

This class implements the ContentHandler interface by writing SAX events back into an XML document. In other words, using an XMLGenerator as the content handler will reproduce the original document being parsed. out should be a file-like object which will default to sys.stdout. encoding is the encoding of the output stream which defaults to 'iso-8859-1'.

class xml.sax.saxutils.XMLFilterBase(base)

这个类被设计用来分隔 XMLReader 和客户端应用的事件处理程序。 在默认情况下，它除了将请求传送给读取器并将事件传送给处理程序之外什么都不做，但其子类可以重载特定的方法以在传送它们的时候修改事件流或配置请求。

xml.sax.saxutils.prepare_input_source(source[, base])

此函数接受一个输入源和一个可选的基准 URL 并返回一个经过完整解析可供读取的 InputSource。 输入源的给出形式可以为字符串、文件类对象或 InputSource 对象；解析器将使用此函数来针对它们的 parse() 方法实现多态 source 参数。