Класс QSqlResult

Класс QSqlResult предоставляет абстрактный интерфейс для доступа к данным из конкретных баз данных SQL. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Защищенные типы

Защищенные функции

Подробное описание

Обычно вы используете QSqlQuery вместо QSqlResult, так как QSqlQuery предоставляет универсальную оболочку для баз данных, реализующих QSqlResult.

Если вы реализуете собственный драйвер SQL (наследуя QSqlDriver), вам потребуется предоставить собственный подкласс QSqlResult, реализующий все чисто виртуальные функции и другие виртуальные функции, которые вам необходимы.

См. также QSqlDriver.

Документация по типам членов

перечисление QSqlResult::BindingSyntax

Этот тип перечисления определяет различные синтаксисы для указания заглушек в подготовленных запросах.

См. также bindingSyntax().

Документация по функциям-членам

[protected] QSqlResult::QSqlResult(const QSqlDriver *db)

Создает QSqlResult с использованием драйвера базы данных db. Объект инициализируется в неактивном состоянии.

См. также isActive() и driver().

[virtual] QSqlResult::~QSqlResult()

Уничтожает объект и освобождает все выделенные ресурсы.

[protected] void QSqlResult::addBindValue(const QVariant &val, QSql::ParamType paramType)

Связывает значение val типа параметра paramType со следующим доступным положением в текущей записи (строке).

См. также bindValue().

[protected] int QSqlResult::at() const

Возвращает текущую (нумерацию с нуля) позицию строки результата. Может возвращать специальные значения QSql::BeforeFirstRow или QSql::AfterLastRow.

См. также setAt() и isValid().

[virtual protected] void QSqlResult::bindValue(int index, const QVariant &val, QSql::ParamType paramType)

Связывает значение val типа параметра paramType с позицией index в текущей записи (строке).

См. также addBindValue().

[virtual protected] void QSqlResult::bindValue(const QString &placeholder, const QVariant &val, QSql::ParamType paramType)

Это перегруженный метод.

Связывает значение val типа параметра paramType с именем placeholder в текущей записи (строке).

Примечание: Связывание неопределенного placeholder приведет к неопределенному поведению.

См. также QSqlQuery::bindValue().

[protected] QSql::ParamType QSqlResult::bindValueType(int index) const

Возвращает тип параметра для значения, связанного с позицией index.

См. также boundValue().

[protected] QSql::ParamType QSqlResult::bindValueType(const QString &placeholder) const

Это перегруженный метод.

Возвращает тип параметра для значения, связанного с указанным именем placeholder.

[protected] QSqlResult::BindingSyntax QSqlResult::bindingSyntax() const

Возвращает синтаксис связывания, используемый подготовленными запросами.

[protected] QVariant QSqlResult::boundValue(int index) const

Возвращает значение, связанное с позицией index в текущей записи (строке).

См. также bindValue() и boundValues().

[protected] QVariant QSqlResult::boundValue(const QString &placeholder) const

Это перегруженный метод.

Возвращает значение, связанное с указанным именем placeholder в текущей записи (строке).

См. также bindValueType().

[protected] int QSqlResult::boundValueCount() const

Возвращает количество связанных значений в результате.

См. также boundValues().

[protected] QString QSqlResult::boundValueName(int index) const

Возвращает имя связанного значения с позицией index в текущей записи (строке).

См. также boundValue().

[protected] QVector<QVariant> &QSqlResult::boundValues() const

Возвращает вектор связанных значений результата для текущей записи (строки).

См. также boundValueCount().

[protected] void QSqlResult::clear()

Очищает весь набор результатов и освобождает все связанные ресурсы.

[pure virtual protected] QVariant QSqlResult::data(int index)

Возвращает данные для поля index в текущей строке в виде QVariant. Эта функция вызывается только в том случае, если результат находится в активном состоянии, расположен на валидной записи, и index не отрицательное число. Производные классы должны переопределить эту функцию и вернуть значение поля index или QVariant(), если его нельзя определить.

[protected] const QSqlDriver *QSqlResult::driver() const

Возвращает драйвер, связанный с результатом. Это объект, переданный в конструктор.

[virtual protected] bool QSqlResult::exec()

Выполняет запрос, возвращает true при успехе; иначе возвращает false.

См. также prepare().

[protected] QString QSqlResult::executedQuery() const

Возвращает запрос, который был фактически выполнен. Он может отличаться от переданного запроса, например, если использовались связанные значения с подготовленным запросом, а базовая база данных не поддерживает подготовленные запросы.

См. также exec() и setQuery().

[pure virtual protected] bool QSqlResult::fetch(int index)

Устанавливает результат на произвольную (нумерация с нуля) строку index.

Эта функция вызывается только если результат находится в активном состоянии. Производные классы должны переопределить эту функцию и установить результат на строку index, а затем вызвать setAt() с соответствующим значением. Возвращает true для обозначения успеха или false для обозначения неудачи.

См. также isActive(), fetchFirst(), fetchLast(), fetchNext() и fetchPrevious().

[pure virtual protected] bool QSqlResult::fetchFirst()

Устанавливает результат на первую запись (строка 0) в результате.

Эта функция вызывается только если результат находится в активном состоянии. Производные классы должны переопределить эту функцию и установить результат на первую запись, а затем вызвать setAt() с соответствующим значением. Возвращает true для обозначения успеха или false для обозначения неудачи.

См. также fetch() и fetchLast().

[pure virtual protected] bool QSqlResult::fetchLast()

Устанавливает результат на последнюю запись (последняя строка) в результате.

Эта функция вызывается только если результат находится в активном состоянии. Производные классы должны переопределить эту функцию и установить результат на последнюю запись, а затем вызвать setAt() с соответствующим значением. Возвращает true для обозначения успеха или false для обозначения неудачи.

См. также fetch() и fetchFirst().

[virtual protected] bool QSqlResult::fetchNext()

Устанавливает результат на следующую доступную запись (строку) в результате.

Эта функция вызывается только если результат находится в активном состоянии. Стандартная реализация вызывает fetch() со следующим индексом. Производные классы могут переопределить эту функцию и установить результат на следующую запись иным способом, и вызвать setAt() с соответствующим значением. Возвращает true для обозначения успеха или false для обозначения неудачи.

См. также fetch() и fetchPrevious().

[virtual protected] bool QSqlResult::fetchPrevious()

Устанавливает результат на предыдущую запись (строку) в результате.

Эта функция вызывается только если результат находится в активном состоянии. Стандартная реализация вызывает fetch() с предыдущим индексом. Производные классы могут переопределить эту функцию и установить результат на предыдущую запись иным способом, и вызвать setAt() с соответствующим значением. Возвращает true для обозначения успеха или false для обозначения неудачи.

[virtual] QVariant QSqlResult::handle() const

Возвращает низкоуровневую базу данных для этого набора результатов, обернутую в QVariant, или недействительный QVariant, если нет дескриптора.

Предупреждение: Используйте с особой осторожностью и только если вы знаете, что делаете.

Предупреждение: Возвращаемый дескриптор может стать устаревшим указателем, если результат изменен (например, если вы очистите его).

Предупреждение: Дескриптор может быть NULL, если результат еще не был выполнен.

Предупреждение: PostgreSQL: в режиме только вперед (forward-only) дескриптор QSqlResult может измениться после вызова fetch(), fetchFirst(), fetchLast(), fetchNext(), fetchPrevious(), nextResult().

Возвращаемая здесь ручка зависит от базы данных, перед доступом к ней следует запросить имя типа варианта.

Этот пример получает ручку для результата sqlite:

QSqlDatabase db = QSqlDatabase::database("sales");
QSqlQuery query("SELECT NAME, DOB FROM EMPLOYEES", db);

QVariant v = query.result()->handle();
if (v.isValid() && qstrcmp(v.typeName(), "sqlite3_stmt*") == 0) {
    // v.data() returns a pointer to the handle
    sqlite3_stmt *handle = *static_cast<sqlite3_stmt **>(v.data());
    if (handle) {
        // ...
    }
}

Этот фрагмент возвращает ручку для PostgreSQL или MySQL:

if (qstrcmp(v.typeName(), "PGresult*") == 0) {
    PGresult *handle = *static_cast<PGresult **>(v.data());
    if (handle) {
        // ...
        }
}

if (qstrcmp(v.typeName(), "MYSQL_STMT*") == 0) {
    MYSQL_STMT *handle = *static_cast<MYSQL_STMT **>(v.data());
    if (handle) {
        // ...
        }
    }

См. также QSqlDriver::handle().

[protected] bool QSqlResult::hasOutValues() const

Возвращает true, если хотя бы одно из связанных значений запроса является QSql::Out или QSql::InOut; в противном случае возвращает false.

См. также bindValueType().

[protected] bool QSqlResult::isActive() const

Возвращает true, если результат содержит записи для извлечения; в противном случае возвращает false.

[protected] bool QSqlResult::isForwardOnly() const

Возвращает true, если можно прокручивать только вперёд по набору результатов; в противном случае возвращает false.

См. также setForwardOnly().

[pure virtual protected] bool QSqlResult::isNull(int index)

Возвращает true, если поле в позиции index в текущей строке имеет значение NULL; в противном случае возвращает false.

[protected] bool QSqlResult::isSelect() const

Возвращает true, если текущий результат получен из SELECT оператора; в противном случае возвращает false.

См. также setSelect().

[protected] bool QSqlResult::isValid() const

Возвращает true, если результат расположен на допустимой записи (то есть результат не расположен до первой или после последней записи); в противном случае возвращает false.

См. также at().

[protected] QSqlError QSqlResult::lastError() const

Возвращает последнюю ошибку, связанную с результатом.

См. также setLastError().

[virtual protected] QVariant QSqlResult::lastInsertId() const

Возвращает идентификатор объекта последней вставленной строки, если база данных его поддерживает. Недействительный QVariant будет возвращён, если запрос не вставил никакого значения или база данных не сообщила об идентификаторе обратно. Если несколько строк были затронуты вставкой, поведение не определено.

Обратите внимание, что для баз данных Oracle будет возвращён ROWID строки, а для баз данных MySQL — поле автоинкремента строки.

См. также QSqlDriver::hasFeature().

[protected] QString QSqlResult::lastQuery() const

Возвращает текст текущего SQL-запроса или пустую строку, если его нет.

См. также setQuery().

[pure virtual protected] int QSqlResult::numRowsAffected()

Возвращает количество строк, затронутых последним выполненным запросом, или -1, если его нельзя определить или если запрос является SELECT оператором.

См. также size().

[virtual protected] bool QSqlResult::prepare(const QString &query)

Подготавливает заданный запрос query к выполнению; запрос обычно будет использовать плейсхолдеры, чтобы его можно было выполнять повторно. Возвращает true, если запрос подготовлен успешно; в противном случае возвращает false.

См. также exec().

[virtual protected] QSqlRecord QSqlResult::record() const

Возвращает текущую запись, если запрос активен; в противном случае возвращает пустую QSqlRecord.

Реализация по умолчанию всегда возвращает пустую QSqlRecord.

См. также isActive().

[pure virtual protected] bool QSqlResult::reset(const QString &query)

Устанавливает результат для использования SQL-оператора query для последующего извлечения данных.

Производные классы должны переопределить эту функцию и применить query к базе данных. Эта функция вызывается только после того, как результат установлен в неактивное состояние и расположен перед первой записью нового результата. Производные классы должны вернуть true, если запрос выполнился успешно и готов к использованию, или false в противном случае.

См. также setQuery().

[protected] void QSqlResult::resetBindCount()

Сбрасывает количество параметров связывания.

[virtual protected] bool QSqlResult::savePrepare(const QString &query)

Подготавливает заданный query, используя функциональность базовой базы данных, где это возможно. Возвращает true, если запрос подготовлен успешно; в противном случае возвращает false.

Примечание: Этот метод должен был называться "safePrepare()".

См. также prepare().

[virtual protected] void QSqlResult::setActive(bool active)

Эта функция предоставляется производным классам для установки внутреннего активного состояния на active.

См. также isActive().

[virtual protected] void QSqlResult::setAt(int index)

Эта функция предоставляется производным классам для установки внутреннего (нумерация с нуля) положения строки на index.

См. также at().

[virtual protected] void QSqlResult::setForwardOnly(bool forward)

Устанавливает режим только вперёд на forward. Если forward имеет значение true, разрешено только fetchNext() для навигации по результатам. Режим только вперёд требует намного меньше памяти, так как результаты не нужно кэшировать. По умолчанию эта функция отключена.

Установка режима только вперёд в значение false является рекомендацией для движка базы данных, который имеет последнее слово в отношении того, является ли набор результатов только вперёд или прокручиваемым. isForwardOnly() всегда будет возвращать правильный статус набора результатов.

Примечание: Вызов setForwardOnly после выполнения запроса в лучшем случае приведёт к неожиданным результатам, а в худшем — к сбою.

Примечание: Чтобы убедиться, что запрос только вперёд завершился успешно, приложение должно проверить lastError() на наличие ошибки не только после выполнения запроса, но и после навигации по результатам запроса.

Предупреждение: PostgreSQL: Во время навигации по результатам запроса в режиме только вперёд не выполняйте другие SQL-команды в том же соединении с базой данных. Это приведёт к потере результатов запроса.

См. также isForwardOnly(), fetchNext() и QSqlQuery::setForwardOnly().

[virtual protected] void QSqlResult::setLastError(const QSqlError &error)

Эта функция предоставляется производным классам для установки последней ошибки на error.

См. также lastError().

[virtual protected] void QSqlResult::setQuery(const QString &query)

Устанавливает текущий запрос для результата на query. Вам необходимо вызвать reset(), чтобы выполнить запрос в базе данных.

См. также reset() и lastQuery().

[virtual protected] void QSqlResult::setSelect(bool select)

Эта функция предоставляется производным классам для указания того, является ли текущий оператор SQL SELECT оператором. Параметр select должен иметь значение true, если оператор является SELECT оператором; в противном случае он должен быть false.

См. также isSelect().

[pure virtual protected] int QSqlResult::size()

Возвращает размер SELECT результата или -1, если его невозможно определить или если запрос не является SELECT оператором.

См. также numRowsAffected().