QSqlError Class
The QSqlError class provides SQL database error information. More...
| Header: | #include <QSqlError> |
| CMake: | find_package(Qt6 COMPONENTS Sql REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Sql) |
| qmake: | QT += sql |
Public Types
| enum | ErrorType { NoError, ConnectionError, StatementError, TransactionError, UnknownError } |
Public Functions
| QSqlError(QSqlError &&other) | |
| QSqlError(const QSqlError &other) | |
| QSqlError(const QString &driverText = QString(), const QString &databaseText = QString(), QSqlError::ErrorType type = NoError, const QString &code = QString()) | |
| QSqlError & | operator=(QSqlError &&other) |
| QSqlError & | operator=(const 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 |
| bool | operator==(const QSqlError &other) const |
Detailed Description
A QSqlError object can provide database-specific error data, including the driverText() and databaseText() messages (or both concatenated together as text()), and the nativeErrorCode() and type().
See also QSqlDatabase::lastError() and QSqlQuery::lastError().
Member Type Documentation
enum QSqlError::ErrorType
This enum type describes the context in which the error occurred, e.g., a connection error, a statement error, etc.
| Constant | Value | Description |
|---|---|---|
QSqlError::NoError | 0 | No error occurred. |
QSqlError::ConnectionError | 1 | Connection error. |
QSqlError::StatementError | 2 | SQL statement syntax error. |
QSqlError::TransactionError | 3 | Transaction failed error. |
QSqlError::UnknownError | 4 | Unknown error. |
Member Function Documentation
[since 5.10] QSqlError::QSqlError(QSqlError &&other)
Move-constructs a QSqlError instance, making it point at the same object that other was pointing to.
Note: The moved-from object other is placed in a partially-formed state, in which the only valid operations are destruction and assignment of a new value.
This function was introduced in Qt 5.10.
QSqlError::QSqlError(const QSqlError &other)
Creates a copy of other.
QSqlError::QSqlError(const QString &driverText = QString(), const QString &databaseText = QString(), QSqlError::ErrorType type = NoError, const QString &code = QString())
Constructs an error containing the driver error text driverText, the database-specific error text databaseText, the type type and the error code code.
Note: DB2: It is possible for DB2 to report more than one error code. When this happens, ; is used as separator between the error codes.
[since 5.10] QSqlError &QSqlError::operator=(QSqlError &&other)
Move-assigns other to this QSqlError instance.
Note: The moved-from object other is placed in a partially-formed state, in which the only valid operations are destruction and assignment of a new value.
This function was introduced in Qt 5.10.
QSqlError &QSqlError::operator=(const QSqlError &other)
Assigns the other error's values to this error.
QSqlError::~QSqlError()
Destroys the object and frees any allocated resources.
QString QSqlError::databaseText() const
Returns the text of the error as reported by the database. This may contain database-specific descriptions; it may be empty.
See also driverText() and text().
QString QSqlError::driverText() const
Returns the text of the error as reported by the driver. This may contain database-specific descriptions. It may also be empty.
See also databaseText() and text().
bool QSqlError::isValid() const
Returns true if an error is set, otherwise false.
Example:
QSqlQueryModel model; model.setQuery("select * from myTable"); if (model.lastError().isValid()) qDebug() << model.lastError();
See also type().
QString QSqlError::nativeErrorCode() const
Returns the database-specific error code, or an empty string if it cannot be determined.
[since 5.10] void QSqlError::swap(QSqlError &other)
Swaps error other with this error. This operation is very fast and never fails.
This function was introduced in Qt 5.10.
QString QSqlError::text() const
This is a convenience function that returns databaseText() and driverText() concatenated into a single string.
See also driverText() and databaseText().
QSqlError::ErrorType QSqlError::type() const
Returns the error type, or -1 if the type cannot be determined.
bool QSqlError::operator!=(const QSqlError &other) const
Compare the other error's values to this error and returns true if it is not equal.
bool QSqlError::operator==(const QSqlError &other) const
Compare the other error's values to this error and returns true, if it equal.