CopperSpice API  1.7.2
QSqlError Class Reference

Provides SQL database error information. More...

Public Types

enum  ErrorType
 

Public Methods

 QSqlError (const QSqlError &other)
 
 QSqlError (const QString &driverText=QString (), const QString &databaseText=QString (), ErrorType type=NoError, const QString &errorCode=QString ())
 
 ~QSqlError ()
 
QString databaseText () const
 
QString driverText () const
 
bool isValid () const
 
QString nativeErrorCode () const
 
QSqlError & operator= (const QSqlError &other)
 
QString text () const
 
ErrorType type () const
 

Detailed Description

The QSqlError class provides SQL database error information.

A QSqlError object can provide database-specific error data, including the driverText() and databaseText() messages (or both concatenated together as text()), and the error number() and type(). The functions all have setters so that you can create and return QSqlError objects from your own classes, for example from your own SQL drivers.

See also
QSqlDatabase::lastError(), QSqlQuery::lastError()

Member Enumeration Documentation

This enum type describes the context in which the error occurred, e.g., a connection error, a statement error, etc.

ConstantValueDescription
QSqlError::NoError0No error occurred.
QSqlError::ConnectionError1Connection error.
QSqlError::StatementError2SQL statement syntax error.
QSqlError::TransactionError3Transaction failed error.
QSqlError::UnknownError4Unknown error.

Constructor & Destructor Documentation

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

Constructs an error containing the driver error text driverText, the database-specific error text databaseText, the type type and the error code errorCode.

QSqlError::QSqlError ( const QSqlError &  other)

Creates a copy of other.

QSqlError::~QSqlError ( )

Destroys the object and frees any allocated resources.

Method Documentation

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
setDatabaseText(), driverText(), 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
setDriverText(), databaseText(), text()
bool QSqlError::isValid ( ) const

Returns true if an error is set, otherwise false.

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 can not be determined.

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

Assigns the other error's values to this error.

QString QSqlError::text ( ) const

This is a convenience function that returns databaseText() and driverText() concatenated into a single string.

See also
driverText(), databaseText()
ErrorType QSqlError::type ( ) const

Returns the error type, or -1 if the type can not be determined.