Класс QSqlError
Класс QSqlError предоставляет информацию об ошибках SQL базы данных. Подробнее...
| Заголовок: | #include <QSqlError> |
| CMake: | find_package(Qt6 COMPONENTS Sql REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Sql) |
| qmake: | QT += sql |
Типы публичного интерфейса
| Перечисление | ErrorType { НетОшибки, ОшибкаПодключения, ОшибкаЗапроса, ОшибкаТранзакции, НеизвестнаяОшибка } |
Публичные функции
| QSqlError(QSqlError &&other) | |
| QSqlError(const QSqlError &other) | |
| QSqlError(const QString &driverText = QString(), const QString &databaseText = QString(), QSqlError::ErrorType type = НетОшибки, 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 |
Подробное описание
Объект QSqlError может предоставлять данные об ошибках базы данных, включая сообщения driverText() и databaseText() (или их объединение как text()), а также nativeErrorCode() и type().
См. также QSqlDatabase::lastError() и QSqlQuery::lastError().
Документация по типам членов
Перечисление QSqlError::ErrorType
Это перечисление описывает контекст возникновения ошибки, например, ошибка подключения, ошибка запроса и т. д.
| Константа | Значение | Описание |
|---|---|---|
QSqlError::NoError |
0 |
Ошибка не возникла. |
QSqlError::ConnectionError |
1 |
Ошибка подключения. |
QSqlError::StatementError |
2 |
Синтаксическая ошибка SQL-запроса. |
QSqlError::TransactionError |
3 |
Ошибка транзакции. |
QSqlError::UnknownError |
4 |
Неизвестная ошибка. |
Документация по функциям-членам
[since 5.10] QSqlError::QSqlError(QSqlError &&other)
Создаёт объект QSqlError, указывая на тот же объект, на который указывал other.
Примечание: Перемещённый объект other находится в частично сформированном состоянии, в котором единственные допустимые операции — уничтожение и присвоение нового значения.
Эта функция была введена в Qt 5.10.
QSqlError::QSqlError(const QSqlError &other)
Создаёт копию объекта other.
QSqlError::QSqlError(const QString &driverText = QString(), const QString &databaseText = QString(), QSqlError::ErrorType type = НетОшибки, const QString &code = QString())
Создаёт ошибку, содержащую текст ошибки драйвера driverText, текст ошибки базы данных databaseText, тип type и код ошибки code.
Примечание: DB2: Возможно, DB2 может сообщать больше одного кода ошибки. В таком случае ; используется в качестве разделителя между кодами ошибок.
[since 5.10] QSqlError &QSqlError::operator=(QSqlError &&other)
Перемещает other в этот объект QSqlError.
Примечание: Перемещённый объект other находится в частично сформированном состоянии, в котором единственные допустимые операции — уничтожение и присвоение нового значения.
Эта функция была введена в Qt 5.10.
QSqlError &QSqlError::operator=(const QSqlError &other)
Присваивает значения ошибки other к текущей ошибке.
QSqlError::~QSqlError()
Уничтожает объект и освобождает все выделенные ресурсы.
QString QSqlError::databaseText() const
Возвращает текст ошибки, полученный от базы данных. Может содержать описания, специфичные для базы данных; может быть пустым.
См. также driverText() и text().
QString QSqlError::driverText() const
Возвращает текст ошибки, полученный от драйвера. Может содержать описания, специфичные для базы данных. Также может быть пустым.
См. также databaseText() и text().
bool QSqlError::isValid() const
Возвращает true , если ошибка установлена, в противном случае false.
Пример:
QSqlQueryModel model;
model.setQuery("select * from myTable");
if (model.lastError().isValid())
qDebug() << model.lastError(); См. также type().
QString QSqlError::nativeErrorCode() const
Возвращает код ошибки, специфичный для базы данных, или пустую строку, если его нельзя определить.
[since 5.10] void QSqlError::swap(QSqlError &other)
Меняет местами ошибку other с текущей ошибкой. Эта операция очень быстрая и никогда не завершается неудачно.
Эта функция была введена в Qt 5.10.
QString QSqlError::text() const
Это вспомогательная функция, которая возвращает databaseText() и driverText() в виде одной строки.
См. также driverText() и databaseText().
QSqlError::ErrorType QSqlError::type() const
Возвращает тип ошибки или -1, если тип определить нельзя.
bool QSqlError::operator!=(const QSqlError &other) const
Сравнивает значения ошибки other с текущей ошибкой и возвращает true , если они не равны.
bool QSqlError::operator==(const QSqlError &other) const
Сравнивает значения ошибки other с текущей ошибкой и возвращает true, если они равны.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qsqlerror.html