QXmlLexicalHandler Class
QXmlLexicalHandler クラスは、XML データの字句内容を報告するためのインターフェイスを提供します。詳細...
| Header: | #include <QXmlLexicalHandler> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core5Compat)target_link_libraries(mytarget PRIVATE Qt6::Core5Compat) |
| qmake: | QT += core5compat |
| Inherited By: |
注意:このクラスの関数はすべてリエントラントです。
パブリック関数
| virtual | ~QXmlLexicalHandler() |
| virtual bool | comment(const QString &ch) = 0 |
| virtual bool | endCDATA() = 0 |
| virtual bool | endDTD() = 0 |
| virtual bool | endEntity(const QString &name) = 0 |
| virtual QString | errorString() const = 0 |
| virtual bool | startCDATA() = 0 |
| virtual bool | startDTD(const QString &name, const QString &publicId, const QString &systemId) = 0 |
| virtual bool | startEntity(const QString &name) = 0 |
詳細説明
レキシカルハンドラのイベントは、ドキュメント要素だけでなくドキュメント全体に適用され、すべてのレキシカルハンドラのイベントは、コンテンツハンドラの startDocument イベントと endDocument イベントの間に現れます。
レキシカルハンドラはQXmlReader::setLexicalHandler() で設定できます。
このインターフェイスの設計は、SAX2 拡張の LexicalHandler に基づいています。
このインターフェイスはstartDTD(),endDTD(),startEntity(),endEntity(),startCDATA(),endCDATA(),comment() 関数を提供します。
QXmlDTDHandler 、QXmlDeclHandler 、QXmlContentHandler 、QXmlEntityResolver 、QXmlErrorHandlerも参照 。
メンバ関数ドキュメント
[virtual noexcept] QXmlLexicalHandler::~QXmlLexicalHandler()
レキシカルハンドラを破棄する。
[pure virtual] bool QXmlLexicalHandler::comment(const QString &ch)
リーダは、ドキュメント内の任意の場所でXMLコメントを報告するためにこの関数を呼び出す。この関数はコメントのテキストをch に報告します。
この関数がfalse を返した場合、リーダはパージングを停止し、エラーを報告する。リーダは関数errorString() を使用してエラーメッセージを取得します。
[pure virtual] bool QXmlLexicalHandler::endCDATA()
リーダーは、CDATAセクションの終了を報告するためにこの関数を呼び出します。
この関数がfalse を返した場合、リーダはパージングを停止してエラーを報告します。エラーメッセージを取得するには、errorString() 関数を使用します。
startCDATA() およびQXmlContentHandler::characters()も参照 。
[pure virtual] bool QXmlLexicalHandler::endDTD()
リーダは、DTD宣言の終了を報告するためにこの関数を呼び出します。
この関数がfalse を返した場合、リーダはパースを中止してエラーを報告します。エラーメッセージを取得するには、errorString() 関数を使用します。
startDTD()も参照 。
[pure virtual] bool QXmlLexicalHandler::endEntity(const QString &name)
リーダはこの関数を呼び出して、name というエンティティの終了を報告する。
startEntity() を呼び出すごとに、対応する endEntity() が呼び出されます。startEntity() および endEntity() の呼び出しは、適切に入れ子になります。
この関数がfalse を返すと、リーダは解析を停止してエラーを報告します。リーダは、関数errorString() を使用してエラー・メッセージを取得します。
startEntity()、QXmlContentHandler::skippedEntity() およびQXmlSimpleReader::setFeature()も参照してください 。
[pure virtual] QString QXmlLexicalHandler::errorString() const
ハンドラ関数のいずれかがfalse を返した場合、リーダはこの関数を呼び出してエラー文字列を取得する。
[pure virtual] bool QXmlLexicalHandler::startCDATA()
リーダーは、CDATAセクションの開始を報告するためにこの関数を呼び出す。CDATAセクションの内容は、QXmlContentHandler::characters （）関数を通して報告される。この関数は、境界を報告することのみを目的としています。
この関数がfalse を返した場合、リーダはパースを中止し、エラーを報告する。エラーメッセージを取得するには、errorString() 関数を使用します。
endCDATA()も参照 。
[pure virtual] bool QXmlLexicalHandler::startDTD(const QString &name, const QString &publicId, const QString &systemId)
リーダは、DTD宣言の開始を報告するためにこの関数を呼び出します。この関数は、name で文書型名を、publicId で公開識別子を、systemId でシステム識別子を報告する。
パブリック識別子がない場合、publicId は空文字列に設定される。システム識別子がない場合、systemId は空文字列に設定される。このような場合、解析エラーが発生する。
このような場合、解析エラーが発生する。QXmlDTDHandler またはQXmlDeclHandler によって報告される宣言はすべて、startDTD() とendDTD() 呼び出しの間に現れる。
この関数がfalse を返した場合、リーダはパースを中止し、エラーを報告する。リーダーは、errorString() 関数を使用してエラー・メッセージを取得する。
endDTD()も参照 。
[pure virtual] bool QXmlLexicalHandler::startEntity(const QString &name)
リーダはこの関数を呼び出して、name というエンティティの開始を報告する。
実体が不明な場合、リーダはこの関数ではなくQXmlContentHandler::skippedEntity() を通して報告することに注意。
この関数がfalse を返した場合、リーダは解析を中止してエラーを報告する。リーダは、関数errorString() を使用してエラー・メッセージを取得します。
endEntity() およびQXmlSimpleReader::setFeature()も参照してください 。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
