Back to Qt.io
Contact Us Blog Download Qt

QSqlError Class

QSqlError クラスは SQL データベースエラー情報を提供します。詳細...

Header: #include <QSqlError>
CMake: find_package(Qt6 REQUIRED COMPONENTS Sql)
target_link_libraries(mytarget PRIVATE Qt6::Sql)
qmake: QT += sql

パブリック型

enum ErrorType { NoError, ConnectionError, StatementError, TransactionError, UnknownError }

パブリック関数

QSqlError(const QString &driverText = QString(), const QString &databaseText = QString(), QSqlError::ErrorType type = NoError, const QString &code = QString())
QSqlError(const QSqlError &other)
QSqlError(QSqlError &&other)
~QSqlError()
QString databaseText() const
QString driverText() const
bool isValid() const
QString nativeErrorCode() const
void swap(QSqlError &other)
QString text() const
QSqlError::ErrorType type() const
bool operator!=(const QSqlError &other) const
QSqlError &operator=(QSqlError &&other)
QSqlError &operator=(const QSqlError &other)
bool operator==(const QSqlError &other) const

詳細説明

QSqlError オブジェクトは、driverText() およびdatabaseText() メッセージ (または両方を連結したtext()) や、nativeErrorCode() およびtype() など、データベース固有のエラー データを提供できます。

QSqlDatabase::lastError() およびQSqlQuery::lastError()も参照 。

メンバ型ドキュメント

enum QSqlError::ErrorType

この列挙型は、接続エラーやステートメントエラーなど、エラーが発生したコンテキストを記述します。

定数値説明
QSqlError::NoError0エラーは発生しませんでした。
QSqlError::ConnectionError1接続エラー。
QSqlError::StatementError2SQL 文構文エラー。
QSqlError::TransactionError3トランザクション失敗エラー。
QSqlError::UnknownError4不明なエラー

メンバ関数ドキュメント

QSqlError::QSqlError(const QString &driverText = QString(), const QString &databaseText = QString(), QSqlError::ErrorType type = NoError, const QString &code = QString())

ドライバのエラー・テキストdriverText 、データベース固有のエラー・テキストdatabaseText 、型type 、エラー・コードcode を含むエラーを構築します。

QSqlError::QSqlError(const QSqlError &other)

other のコピーを作成します。

[noexcept] QSqlError::QSqlError(QSqlError &&other)

移動-QSqlError インスタンスを構築し、other が指していたのと同じオブジェクトを指すようにします。

注意: 移動元のオブジェクトother は部分的に形成された状態に置かれます。この状態では、有効な操作は破棄と新しい値の割り当てのみです。

[noexcept] QSqlError::~QSqlError()

オブジェクトを破棄し、割り当てられたリソースを解放する。

QString QSqlError::databaseText() const

データベースから報告されたエラーのテキストを返します。これにはデータベース固有の説明が含まれることもありますし、空であることもあります。

driverText() およびtext()も参照 。

QString QSqlError::driverText() const

ドライバが報告したエラーのテキストを返します。これにはデータベース固有の説明が含まれることがあります。空の場合もあります。

databaseText() およびtext() も参照 。

bool QSqlError::isValid() const

エラーが設定されている場合はtrue を返し、そうでない場合は false を返します。

例：

QSqlQueryModel model;
model.setQuery("select * from myTable");
if (model.lastError().isValid())
    qDebug() << model.lastError();

type() も参照 。

QString QSqlError::nativeErrorCode() const

データベース固有のエラーコードを返すか、判別できない場合は空文字列を返します。

注意: いくつかのドライバ (DB2 や ODBC など) は、複数のエラーコードを返すことがあります。このような場合は、; をエラーコードの区切り文字として使用します。

[noexcept] void QSqlError::swap(QSqlError &other)

エラーother をこのエラーと入れ替えます。この操作は非常に高速で、失敗することはありません。

QString QSqlError::text() const

これは、databaseText() とdriverText() を1つの文字列に連結して返す便利な関数である。

driverText() およびdatabaseText()も参照のこと 。

QSqlError::ErrorType QSqlError::type() const

エラー・タイプを返し、タイプが判別できない場合は -1 を返す。

bool QSqlError::operator!=(const QSqlError &other) const

other エラーのtype() とnativeErrorCode() をこのエラーと比較し、等しくない場合はtrue を返す。

[noexcept] QSqlError &QSqlError::operator=(QSqlError &&other)

移動-このQSqlError インスタンスにother を代入する。

注意： 移動元のオブジェクトother は、部分的に形成された状態に置かれる。この状態では、有効な操作は破棄と新しい値の割り当てのみである。

QSqlError &QSqlError::operator=(const QSqlError &other)

other エラーの値をこのエラーに代入する。

bool QSqlError::operator==(const QSqlError &other) const

other エラーのtype() とnativeErrorCode() をこのエラーと比較し、等しければtrue を返します。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。