QSqlError Class
La classe QSqlError fournit des informations sur les erreurs de la base de données SQL. Plus d'informations...
| En-tête : | #include <QSqlError> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Sql)target_link_libraries(mytarget PRIVATE Qt6::Sql) |
| qmake : | QT += sql |
- Liste de tous les membres, y compris les membres hérités
- QSqlError fait partie des classes de bases de données.
Types publics
| enum | ErrorType { NoError, ConnectionError, StatementError, TransactionError, UnknownError } |
Fonctions publiques
| 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 |
Description détaillée
Un objet QSqlError peut fournir des données d'erreur spécifiques à une base de données, notamment les messages driverText() et databaseText() (ou les deux concaténés ensemble sous la forme text()), ainsi que les messages nativeErrorCode() et type().
Voir également QSqlDatabase::lastError() et QSqlQuery::lastError().
Documentation sur les types de membres
enum QSqlError::ErrorType
Ce type d'énumération décrit le contexte dans lequel l'erreur s'est produite, par exemple une erreur de connexion, une erreur d'instruction, etc.
| Constante | Valeur | Description de l'erreur |
|---|---|---|
QSqlError::NoError | 0 | Aucune erreur n'est survenue. |
QSqlError::ConnectionError | 1 | Erreur de connexion. |
QSqlError::StatementError | 2 | Erreur de syntaxe de l'instruction SQL. |
QSqlError::TransactionError | 3 | Erreur d'échec de la transaction. |
QSqlError::UnknownError | 4 | Erreur inconnue. |
Documentation des fonctions membres
QSqlError::QSqlError(const QString &driverText = QString(), const QString &databaseText = QString(), QSqlError::ErrorType type = NoError, const QString &nativeErrorCode = QString())
Construit une erreur contenant le texte d'erreur du pilote driverText, le texte d'erreur spécifique à la base de données databaseText, le type type et le code d'erreur natif nativeErrorCode.
QSqlError::QSqlError(const QSqlError &other)
Crée une copie de other.
[constexpr noexcept] QSqlError::QSqlError(QSqlError &&other)
Move-construit une instance de QSqlError, en la faisant pointer sur le même objet que celui vers lequel other pointait.
Remarque : l'objet déplacé other est placé dans un état partiellement formé, dans lequel les seules opérations valides sont la destruction et l'attribution d'une nouvelle valeur.
[noexcept] QSqlError::~QSqlError()
Détruit l'objet et libère les ressources allouées.
QString QSqlError::databaseText() const
Renvoie le texte de l'erreur tel qu'il est rapporté par la base de données. Ce texte peut contenir des descriptions spécifiques à la base de données ; il peut être vide.
Voir aussi driverText() et text().
QString QSqlError::driverText() const
Renvoie le texte de l'erreur tel qu'il a été signalé par le pilote. Il peut contenir des descriptions spécifiques à la base de données. Il peut également être vide.
Voir aussi databaseText() et text().
bool QSqlError::isValid() const
Renvoie true si une erreur est définie, sinon false.
Exemple :
QSqlQueryModel model ; model.setQuery("select * from myTable") ;if (model.lastError().isValid()) qDebug() << model.lastError();
Voir aussi type().
QString QSqlError::nativeErrorCode() const
Renvoie le code d'erreur spécifique à la base de données (natif), ou une chaîne vide s'il ne peut être déterminé.
Remarque : certains pilotes (comme DB2 ou ODBC) peuvent renvoyer plus d'un code d'erreur. Dans ce cas, ; est utilisé comme séparateur entre les codes d'erreur.
[noexcept] void QSqlError::swap(QSqlError &other)
Remplace cette erreur par other. Cette opération est très rapide et n'échoue jamais.
QString QSqlError::text() const
Il s'agit d'une fonction de commodité qui renvoie databaseText() et driverText() concaténés en une seule chaîne de caractères.
Voir aussi driverText() et databaseText().
QSqlError::ErrorType QSqlError::type() const
Renvoie le type d'erreur, ou -1 si le type ne peut être déterminé.
bool QSqlError::operator!=(const QSqlError &other) const
Comparez les erreurs type() et nativeErrorCode() de l'erreur other à cette erreur et renvoyez true si elles ne sont pas égales.
[noexcept] QSqlError &QSqlError::operator=(QSqlError &&other)
Move-assigne other à cette instance QSqlError.
Note : L'objet déplacé other est placé dans un état partiellement formé, dans lequel les seules opérations valides sont la destruction et l'attribution d'une nouvelle valeur.
QSqlError &QSqlError::operator=(const QSqlError &other)
Affecte les valeurs de l'erreur other à cette erreur.
bool QSqlError::operator==(const QSqlError &other) const
Comparez les messages type() et nativeErrorCode() de l'erreur other à cette erreur et renvoyez true, s'ils sont identiques.
© 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.
