QXmlContentHandler 类

成员函数文档

[virtual noexcept] QXmlContentHandler::~QXmlContentHandler()

销毁内容处理器。

[pure virtual] bool QXmlContentHandler::characters(const QString &ch)

当解析器解析到一段字符数据（普通字符数据或CDATA部分中的字符数据）时调用此函数。字符数据报告为ch。

一些解析器使用ignorableWhitespace()函数而不是此函数来报告空白。

解析器可以分多次报告一个元素的字符数据；例如，解析器可能会希望通过三个characters()事件报告"a<b"（"a "、"<"和" b"）。

如果此函数返回false，解析器停止解析并报告错误。解析器使用errorString()函数获取错误信息。

[pure virtual] bool QXmlContentHandler::endDocument()

解析器在完成解析后调用此函数。它只调用一次，并且是最后一个处理器函数被调用。它在其读取所有输入或由于致命错误而放弃解析后调用。

如果此函数返回false，解析器停止解析并报告错误。解析器使用errorString()函数获取错误信息。

另请参阅 startDocument。

[pure virtual] bool QXmlContentHandler::endElement(const QString &namespaceURI, const QString &localName, const QString &qName)

当解析器解析到具有限定名qName、本地名localName和命名空间URInamespaceURI的结束元素标签时调用此函数。

如果此函数返回false，解析器停止解析并报告错误。解析器使用errorString()函数获取错误信息。

另请参阅 startElement。

[pure virtual] bool QXmlContentHandler::endPrefixMapping(const QString &prefix)

读者调用此函数以标记前缀前缀 prefix 映射的结束。

如果此函数返回false，解析器停止解析并报告错误。解析器使用errorString()函数获取错误信息。

另请参阅startPrefixMapping。

[纯虚函数] QString QXmlContentHandler::errorString() const

读者调用此函数来获取错误字符串，例如，如果有任何处理函数返回 false。

[纯虚函数] bool QXmlContentHandler::ignorableWhitespace(const QString &ch)

一些阅读器可能使用此函数来报告元素内容中的每个空白块。空白以 ch 的形式报告。

如果此函数返回false，解析器停止解析并报告错误。解析器使用errorString()函数获取错误信息。

[纯虚函数] bool QXmlContentHandler::processingInstruction(const QString &target, const QString &data)

当解析器解析处理指令时，它会调用此函数。

target 是处理指令的目标名称，data 是处理指令中的数据。

如果此函数返回false，解析器停止解析并报告错误。解析器使用errorString()函数获取错误信息。

[纯虚函数] void QXmlContentHandler::setDocumentLocator(QXmlLocator *locator)

在解析文档之前，解析器调用此函数。参数 locator 是一个指向 QXmlLocator 的指针，它允许应用程序获取在文档中的解析位置。

不要销毁 locator；它会在解析器销毁时被销毁。（解析器销毁后不要使用 locator）。

[纯虚函数] bool QXmlContentHandler::skippedEntity(const QString &name)

一些阅读器可能跳过实体，如果它们未看到声明（例如，因为它们在外部 DTD 中）。如果它们这样做，它们将调用此函数来报告它们跳过了名为 name 的实体。

如果此函数返回false，解析器停止解析并报告错误。解析器使用errorString()函数获取错误信息。

[纯虚函数] bool QXmlContentHandler::startDocument()

当解析器开始解析文档时，它会调用此函数。解析器在调用 setDocumentLocator() 之后、调用此类或 QXmlDTDHandler 类中的任何其他函数之前，只调用一次此函数。

如果此函数返回false，解析器停止解析并报告错误。解析器使用errorString()函数获取错误信息。

另请参阅endDocument。

[纯虚函数] bool QXmlContentHandler::startElement(const QString &namespaceURI, const QString &localName, const QString &qName, const QXmlAttributes &atts)

当解析器解析起始元素标签时，它会调用此函数。

在读取相应的结束元素标签时会有相应的 endElement() 调用。startElement() 和 endElement() 调用总是正确嵌套。空元素标签（例如 <x/>）会使 startElement() 调用立即被 endElement() 调用跟随。

提供的属性列表仅包含具有显式值的属性。只有当阅读器的namespace-prefix属性为true时，属性列表才包含用于命名空间声明的属性（即以xmlns开头的属性）。

参数namespaceURI是命名空间URI，如果元素没有命名空间URI或没有进行命名空间处理，则为空字符串。localName是局部名称（不带前缀），如果没有进行命名空间处理，则为空字符串，qName是 qualified name（带前缀）和atts是与元素相关的属性。如果没有属性，atts是一个空的属性对象。

如果此函数返回false，解析器停止解析并报告错误。解析器使用errorString()函数获取错误信息。

另请参阅endElement()。

[纯虚函数] bool QXmlContentHandler::startPrefixMapping(const QString &prefix, const QString &uri)

阅读器调用此函数来指示前缀-URI命名空间映射范围的开头。对于正常的命名空间处理，此信息并非必需，因为阅读器会自动替换元素和属性名称的前缀。

请注意，startPrefixMapping()和endPrefixMapping()调用的嵌套不是保证的：所有startPrefixMapping()事件都发生在相应的startElement()事件之前，所有endPrefixMapping()事件都发生在相应的endElement()事件之后，但它们的顺序没有其他保证。

参数prefix是要声明的命名空间前缀，参数uri是前缀映射到的命名空间URI。

如果此函数返回false，解析器停止解析并报告错误。解析器使用errorString()函数获取错误信息。

另请参阅endPrefixMapping()。