QXmlErrorHandler Class
QXmlErrorHandler クラスは、XML データのエラーを報告するためのインターフェースを提供します。詳細...
| ヘッダー: | #include <QXmlErrorHandler> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core5Compat) target_link_libraries(mytarget PRIVATE Qt6::Core5Compat) |
| qmake: | QT += core5compat |
| 継承元: |
注:このクラスのすべての関数は再入可能である。
パブリック関数
| virtual | ~QXmlErrorHandler() |
| virtual bool | error(const QXmlParseException &exception) = 0 |
| virtual QString | errorString() const = 0 |
| virtual bool | fatalError(const QXmlParseException &exception) = 0 |
| virtual bool | warning(const QXmlParseException &exception) = 0 |
詳細な説明
アプリケーションでユーザーにエラーを報告したり、カスタマイズされたエラー処理を実行したりしたい場合は、このクラスをサブクラス化する必要があります。
エラーハンドラは、QXmlReader::setErrorHandler() を使用して設定できます。
エラーは、warning()、error()、fatalError() を使用して報告でき、エラーテキストはerrorString() を使用して報告されます。
QXmlDTDHandler 、QXmlDeclHandler 、QXmlContentHandler 、QXmlEntityResolver 、およびQXmlLexicalHandlerも参照してください 。
メンバ関数のドキュメント
[virtual noexcept] QXmlErrorHandler::~QXmlErrorHandler()
エラーハンドラを破棄します。
[pure virtual] bool QXmlErrorHandler::error(const QXmlParseException &exception)
リーダーはこの関数を使用して、回復可能なエラーを報告することができます。回復可能なエラーとは、XML 1.0 仕様のセクション 1.2 に定義されている「エラー」に相当します。エラーの詳細は、exception に格納されます。
リーダーは、この関数を呼び出した後も、通常の解析イベントを引き続き提供しなければならない。
この関数がfalse を返した場合、リーダーは解析を中止し、エラーを報告します。リーダーは、関数errorString()を使用してエラーメッセージを取得します。
[pure virtual] QString QXmlErrorHandler::errorString() const
ハンドラ関数のいずれかがfalse を返した場合、リーダーはこの関数を呼び出してエラー文字列を取得します。
[pure virtual] bool QXmlErrorHandler::fatalError(const QXmlParseException &exception)
リーダーは、回復不可能なエラーを報告するためにこの関数を使用する必要があります。エラーの詳細は、exception に格納されます。
この関数が `true ` を返した場合、リーダーは解析を続行してさらなるエラーを報告しようとする可能性がありますが、通常の解析イベントは報告されません。
[pure virtual] bool QXmlErrorHandler::warning(const QXmlParseException &exception)
リーダーはこの関数を使用して、警告を報告することができます。警告とは、XML 1.0 仕様で定義されているエラーや致命的なエラーではない状態のことです。警告の詳細は、exception に格納されます。
この関数が `false ` を返した場合、リーダーは解析を中止し、エラーを報告します。リーダーは、関数 `errorString()` を使用してエラーメッセージを取得します。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
