QSqlError Class
La clase QSqlError proporciona información sobre los errores de las bases de datos SQL. Más información...
| Encabezado: | #include <QSqlError> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Sql) target_link_libraries(mytarget PRIVATE Qt6::Sql) |
| qmake: | QT += sql |
- Lista de todos los miembros, incluidos los heredados
- QSqlError forma parte de las clases de bases de datos.
Tipos públicos
| enum | ErrorType { NoError, ConnectionError, StatementError, TransactionError, UnknownError } |
Funciones públicas
| QSqlError(const QString &driverText = QString(), const QString &databaseText = QString(), QSqlError::ErrorType type = NoError, const QString &nativeErrorCode = 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 |
Descripción detallada
Un objeto QSqlError puede proporcionar datos de error específicos de la base de datos, incluidos los mensajes driverText() y databaseText() (o ambos concatenados como text()), así como nativeErrorCode() y type().
Véase también QSqlDatabase::lastError() y QSqlQuery::lastError().
Documentación sobre tipos de miembros
enum QSqlError::ErrorType
Este tipo de enumeración describe el contexto en el que se produjo el error, por ejemplo, un error de conexión, un error de instrucción, etc.
| Constante | Valor | Descripción |
|---|---|---|
QSqlError::NoError | 0 | No se ha producido ningún error. |
QSqlError::ConnectionError | 1 | Error de conexión. |
QSqlError::StatementError | 2 | Error de sintaxis en la instrucción SQL. |
QSqlError::TransactionError | 3 | Error en la transacción. |
QSqlError::UnknownError | 4 | Error desconocido. |
Documentación de funciones de miembro
QSqlError::QSqlError(const QString &driverText = QString(), const QString &databaseText = QString(), QSqlError::ErrorType type = NoError, const QString &nativeErrorCode = QString())
Crea un objeto de error que contiene el texto de error del controlador driverText, el texto de error específico de la base de datos databaseText, el tipo type y el código de error nativo nativeErrorCode.
QSqlError::QSqlError(const QSqlError &other)
Crea una copia de other.
[constexpr noexcept default] QSqlError::QSqlError(QSqlError &&other)
La operación «move» crea una instancia de QSqlError, haciendo que apunte al mismo objeto al que apuntaba other.
Nota: El objeto del que se ha realizado el movimiento, other, queda en un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.
[noexcept] QSqlError::~QSqlError()
Destruye el objeto y libera los recursos asignados.
QString QSqlError::databaseText() const
Devuelve el texto del error tal y como lo ha notificado la base de datos. Puede contener descripciones específicas de la base de datos; también puede estar vacío.
Véase también driverText() y text().
QString QSqlError::driverText() const
Devuelve el texto del error tal y como lo ha notificado el controlador. Puede contener descripciones específicas de la base de datos. También puede estar vacío.
Véase también databaseText() y text().
bool QSqlError::isValid() const
Devuelve ` true ` si se ha producido un error; en caso contrario, devuelve `false`.
Ejemplo:
QSqlQueryModel model;
model.setQuery("select * from myTable");
if (model.lastError().isValid())
qDebug() << model.lastError();Véase también type().
QString QSqlError::nativeErrorCode() const
Devuelve el código de error específico de la base de datos (nativo) o una cadena vacía si no se puede determinar.
Nota: Algunos controladores (como DB2 u ODBC) pueden devolver más de un código de error. Cuando esto ocurre, se utiliza « ; » como separador entre los códigos de error.
[noexcept] void QSqlError::swap(QSqlError &other)
Sustituye este error por other. Esta operación es muy rápida y nunca falla.
QString QSqlError::text() const
Esta es una función de conveniencia que devuelve databaseText() y driverText() concatenadas en una sola cadena.
Véanse también driverText() y databaseText().
QSqlError::ErrorType QSqlError::type() const
Devuelve el tipo de error, o -1 si no se puede determinar el tipo.
bool QSqlError::operator!=(const QSqlError &other) const
Compara los valores de type() y nativeErrorCode() del error « other » con los de este error y devuelve true si no son iguales.
[noexcept] QSqlError &QSqlError::operator=(QSqlError &&other)
La operación «move-assigns» asigna other a esta instancia de QSqlError.
Nota: El objeto del que se ha realizado el traslado, other, pasa a un estado parcialmente formado, en el que las únicas operaciones válidas son la destrucción y la asignación de un nuevo valor.
QSqlError &QSqlError::operator=(const QSqlError &other)
Asigna los valores del error « other » a este error.
bool QSqlError::operator==(const QSqlError &other) const
Compara los métodos type() y nativeErrorCode() del error « other » con este error y devuelve true si coinciden.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.