QXmlErrorHandler Class
QXmlErrorHandler クラスは、XML データのエラーを報告するための インターフェイスを提供します。詳細...
Header: | #include <QXmlErrorHandler> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Core5Compat) target_link_libraries(mytarget PRIVATE Qt6::Core5Compat) |
qmake: | QT += core5compat |
Inherited By: |
注意:このクラスの関数はすべてリエントラントです。
パブリック関数
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の "error "の定義に対応する。エラーの詳細は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() を使用します。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。