QSqlError

Section: Misc. Reference Manual Pages (3qt)
Updated: 2 February 2007
Index Return to Main Contents

NAME

QSqlError - SQL database error information

SYNOPSIS

Public Members

enum Type { None, Connection, Statement, Transaction, Unknown }

QSqlError ( const QString & driverText = QString::null, const QString & databaseText = QString::null, int type = QSqlError::None, int number = -1 )

QSqlError ( const QSqlError & other )

QSqlError & operator= ( const QSqlError & other )

virtual ~QSqlError ()

QString driverText () const

virtual void setDriverText ( const QString & driverText )

QString databaseText () const

virtual void setDatabaseText ( const QString & databaseText )

int type () const

virtual void setType ( int type )

int number () const

virtual void setNumber ( int number )

QString text () const

void showMessage ( const QString & msg = QString::null ) const (obsolete)

DESCRIPTION

The QSqlError class provides SQL database error information.

This class is used to report database-specific errors. An error description and (if appropriate) a database-specific error number can be obtained using this class.

Member Type Documentation

QSqlError::Type

This enum type describes the type of SQL error that occurred.

QSqlError::None - no error occurred
QSqlError::Connection - connection error
QSqlError::Statement - SQL statement syntax error
QSqlError::Transaction - transaction failed error
QSqlError::Unknown - unknown error

MEMBER FUNCTION DOCUMENTATION

QSqlError::QSqlError ( const QString & driverText = QString::null, const QString & databaseText = QString::null, int type = QSqlError::None, int number = -1 )

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

QSqlError::QSqlError ( const QSqlError & other )

Creates a copy of other.

QSqlError::~QSqlError () [virtual]

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.

QString QSqlError::driverText () const

Returns the text of the error as reported by the driver. This may contain database-specific descriptions.

int QSqlError::number () const

Returns the database-specific error number, or -1 if it cannot be determined.

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

Sets the error equal to other.

void QSqlError::setDatabaseText ( const QString & databaseText ) [virtual]

Sets the database error text to the value of databaseText.

void QSqlError::setDriverText ( const QString & driverText ) [virtual]

Sets the driver error text to the value of driverText.

void QSqlError::setNumber ( int number ) [virtual]

Sets the database-specific error number to number.

void QSqlError::setType ( int type ) [virtual]

Sets the error type to the value of type.

void QSqlError::showMessage ( const QString & msg = QString::null ) const

This function is obsolete. It is provided to keep old source working. We strongly advise against using it in new code.

This is a convenience function that pops up a QMessageBox containing the message returned by text(). An additional string can be passed in via the msg parameter, which will be concatenated with the text() message.

See also text(), driverText(), and databaseText().

QString QSqlError::text () const

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

See also showMessage(), driverText(), and databaseText().

int QSqlError::type () const

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

COPYRIGHT

AUTHOR

Generated automatically from the source code.

BUGS

If you find a bug in Qt, please report it as described in http://doc.trolltech.com/bughowto.html. Good bug reports help us to help you. Thank you. The definitive Qt documentation is provided in HTML format; it is located at $QTDIR/doc/html and can be read using Qt Assistant or with a web browser. This man page is provided as a convenience for those users who prefer man pages, although this format is not officially supported by Trolltech. If you find errors in this manual page, please report them to qt-bugs@trolltech.com. Please include the name of the manual page (qsqlerror.3qt) and the Qt version (3.3.8).