Класс QSqlQuery

Класс QSqlQuery предоставляет средства для выполнения и обработки SQL-запросов. Подробнее...

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

Открытые типы

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

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

Класс QSqlQuery предоставляет средства для выполнения и обработки SQL-запросов.

QSqlQuery инкапсулирует функциональность, связанную с созданием, навигацией и получением данных из SQL-запросов, которые выполняются на базе данных QSqlDatabase. Он может использоваться для выполнения операторов DML (языка манипулирования данными), таких как SELECT, INSERT, UPDATE и DELETE, а также операторов DDL (языка определения данных), таких как CREATE TABLE. Он также может использоваться для выполнения специфичных для базы данных команд, которые не являются стандартным SQL (например, SET DATESTYLE=ISO для PostgreSQL).

Успешно выполненные SQL-запросы устанавливают состояние запроса в активное, так что isActive() возвращает true. В противном случае состояние запроса устанавливается в неактивное. В любом случае, при выполнении нового SQL-запроса запрос размещается на недействительной записи. Активный запрос должен быть перемещён на действительную запись (так что isValid() возвращает true) перед получением значений.

Для некоторых баз данных, если активный запрос, который является SELECT оператором, существует, когда вы вызываете commit() или rollback(), коммит или откат может завершиться неудачей. См. isActive() для получения подробной информации.

Перемещение по записям выполняется с помощью следующих функций:

• next()
• previous()
• first()
• last()
• seek()

Эти функции позволяют программисту перемещаться вперед, назад или произвольно по записям, возвращаемым запросом. Если вам нужно перемещаться только вперед по результатам (например, используя next()), вы можете использовать setForwardOnly(), что сэкономит значительный объем памяти и улучшит производительность на некоторых базах данных. После того, как активный запрос разместится на действительной записи, данные можно получить с помощью value(). Все данные передаются из SQL-бекенда с помощью QVariant.

Например:

    QSqlQuery query("SELECT country FROM artist");
    while (query.next()) {
        QString country = query.value(0).toString();
        doSomething(country);
    }

Для доступа к данным, возвращаемым запросом, используйте value(int). Каждый элемент данных, возвращаемый оператором SELECT, доступен по его позиции в операторе, начиная с 0. Это делает использование запросов SELECT * нежелательным, поскольку порядок возвращаемых элементов не определен.

В целях эффективности нет функций для доступа к элементу по имени (если вы не используете подготовленные запросы с именами, как описано ниже). Для преобразования имени поля в индекс используйте record().indexOf(), например:

    QSqlQuery query("SELECT * FROM artist");
    int fieldNo = query.record().indexOf("country");
    while (query.next()) {
        QString country = query.value(fieldNo).toString();
        doSomething(country);
    }

QSqlQuery поддерживает выполнение подготовленных запросов и привязку значений параметров к плейсхолдерам. Некоторые базы данных не поддерживают эти функции, поэтому Qt эмулирует необходимую функциональность. Например, драйверы Oracle и ODBC имеют надлежащую поддержку подготовленных запросов, и Qt использует её; но для баз данных, которые не имеют этой поддержки, Qt реализует эту функцию самостоятельно, например, замещая плейсхолдеры фактическими значениями при выполнении запроса. Используйте numRowsAffected() для определения того, сколько строк было затронуто не-SELECT запросом, и size() для определения того, сколько было получено SELECT.

Базы данных Oracle идентифицируют плейсхолдеры, используя синтаксис с двоеточием и именем, например :name. ODBC просто использует символы ?. Qt поддерживает оба синтаксиса, с ограничением, что вы не можете смешивать их в одном запросе.

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

Подходы к привязке значений

Ниже мы представляем один и тот же пример, используя каждый из четырёх различных подходов к привязке, а также один пример привязки значений к хранимой процедуре.

Привязка по имени, используя именованные плейсхолдеры:

    QSqlQuery query;
    query.prepare("INSERT INTO person (id, forename, surname) "
                  "VALUES (:id, :forename, :surname)");
    query.bindValue(":id", 1001);
    query.bindValue(":forename", "Bart");
    query.bindValue(":surname", "Simpson");
    query.exec();

Позиционная привязка, используя именованные плейсхолдеры:

    QSqlQuery query;
    query.prepare("INSERT INTO person (id, forename, surname) "
                  "VALUES (:id, :forename, :surname)");
    query.bindValue(0, 1001);
    query.bindValue(1, "Bart");
    query.bindValue(2, "Simpson");
    query.exec();

Привязка значений с использованием позиционных плейсхолдеров (версия 1):

    QSqlQuery query;
    query.prepare("INSERT INTO person (id, forename, surname) "
                  "VALUES (?, ?, ?)");
    query.bindValue(0, 1001);
    query.bindValue(1, "Bart");
    query.bindValue(2, "Simpson");
    query.exec();

Привязка значений с использованием позиционных плейсхолдеров (версия 2):

    QSqlQuery query;
    query.prepare("INSERT INTO person (id, forename, surname) "
                  "VALUES (?, ?, ?)");
    query.addBindValue(1001);
    query.addBindValue("Bart");
    query.addBindValue("Simpson");
    query.exec();

Привязка значений к хранимой процедуре:

Этот код вызывает хранимую процедуру под названием AsciiToInt(), передавая ей символ через входной параметр и получая результат в выходном параметре.

    QSqlQuery query;
    query.prepare("CALL AsciiToInt(?, ?)");
    query.bindValue(0, "A");
    query.bindValue(1, 0, QSql::Out);
    query.exec();
    int i = query.boundValue(1).toInt(); // i is 65

Обратите внимание, что свободные параметры сохранят свои значения.

Хранимые процедуры, которые используют оператор return для возврата значений или возвращают несколько наборов результатов, не полностью поддерживаются. Для получения подробной информации см. Драйверы баз данных SQL.

Предупреждение: Вы должны загрузить драйвер SQL и открыть подключение до создания объекта QSqlQuery. Кроме того, подключение должно оставаться открытым, пока существует запрос; в противном случае поведение QSqlQuery не определено.

См. также QSqlDatabase, QSqlQueryModel, QSqlTableModel и QVariant.

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

перечисление QSqlQuery::BatchExecutionMode

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

QSqlQuery::QSqlQuery(QSqlResult *result)

Создаёт объект QSqlQuery, который использует QSqlResult result для связи с базой данных.

QSqlQuery::QSqlQuery(const QString &query = QString(), QSqlDatabase db = QSqlDatabase())

Создаёт объект QSqlQuery, используя SQL-запрос query и базу данных db. Если db не указана или недействительна, используется базу данных по умолчанию приложения. Если query не пустая строка, она будет выполнена.

См. также QSqlDatabase.

QSqlQuery::QSqlQuery(QSqlDatabase db)

Создаёт объект QSqlQuery, используя базу данных db. Если db недействительна, будет использоваться базу данных по умолчанию приложения.

См. также QSqlDatabase.

QSqlQuery::QSqlQuery(const QSqlQuery &other)

Создаёт копию объекта other.

QSqlQuery::~QSqlQuery()

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

void QSqlQuery::addBindValue(const QVariant &val, QSql::ParamType paramType)

Добавляет значение val в список значений при использовании позиционной привязки значений. Порядок вызовов addBindValue() определяет, к какому плейсхолдеру будет привязано значение в подготовленном запросе. Если paramType равно QSql::Out или QSql::InOut, плейсхолдер будет перезаписан данными из базы данных после вызова exec().

Для привязки значения NULL используйте нулевое значение QVariant; например, используйте QVariant(QVariant::String) при привязке строки.

См. также bindValue(), prepare(), exec(), boundValue() и boundValues().

int QSqlQuery::at() const

Возвращает текущую внутреннюю позицию запроса. Первая запись находится на позиции ноль. Если позиция недопустима, функция возвращает QSql::BeforeFirstRow или QSql::AfterLastRow, которые являются специальными отрицательными значениями.

См. также previous(), next(), first(), last(), seek(), isActive() и isValid().

void QSqlQuery::bindValue(const QString &placeholder, const QVariant &val, QSql::ParamType paramType)

Устанавливает плейсхолдер placeholder для привязки к значению val в подготовленном операторе. Обратите внимание, что маркер плейсхолдера (например, :) должен быть включён при указании имени плейсхолдера. Если paramType равно QSql::Out или QSql::InOut, плейсхолдер будет перезаписан данными из базы данных после вызова exec(). В этом случае необходимо предварительно выделить достаточное место для хранения результата.

Для привязки значения NULL используйте нулевое значение QVariant; например, используйте QVariant(QVariant::String) при привязке строки.

См. также addBindValue(), prepare(), exec(), boundValue() и boundValues().

void QSqlQuery::bindValue(int pos, const QVariant &val, QSql::ParamType paramType)

Устанавливает плейсхолдер на позиции pos для привязки к значению val в подготовленном операторе. Нумерация полей начинается с 0.

QVariant QSqlQuery::boundValue(const QString &placeholder) const

Возвращает значение для placeholder.

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

QVariant QSqlQuery::boundValue(int pos) const

Возвращает значение для плейсхолдера на позиции pos.

QMap<QString, QVariant> QSqlQuery::boundValues() const

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

С именованной привязкой привязанные значения можно проверить следующим образом:

    QMapIterator<QString, QVariant> i(query.boundValues());
    while (i.hasNext()) {
        i.next();
        cout << i.key().toUtf8().data() << ": "
             << i.value().toString().toUtf8().data() << endl;
    }

С позиционной привязкой код становится:

    QList<QVariant> list = query.boundValues().values();
    for (int i = 0; i < list.size(); ++i)
        cout << i << ": " << list.at(i).toString().toUtf8().data() << endl;

См. также boundValue(), bindValue() и addBindValue().

void QSqlQuery::clear()

Очищает набор результатов и освобождает все ресурсы, используемые запросом. Устанавливает состояние запроса в неактивное. Вам редко, если вообще, понадобится вызывать эту функцию.

const QSqlDriver *QSqlQuery::driver() const

Возвращает драйвер базы данных, связанный с запросом.

bool QSqlQuery::exec(const QString &query)

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

После выполнения запроса запрос позиционируется на недействительной записи, и перед получением значений данных необходимо перейти к действительной записи (например, с помощью next()).

Обратите внимание, что последняя ошибка для этого запроса сбрасывается при вызове exec().

Для SQLite строка запроса может содержать только одно утверждение за раз. Если указано более одного утверждения, функция возвращает false.

Пример:

    QSqlQuery query;
    query.exec("INSERT INTO employee (id, name, salary) "
               "VALUES (1001, 'Thad Beaumont', 65000)");

См. также isActive(), isValid(), next(), previous(), first(), last() и seek().

bool QSqlQuery::exec()

Выполняет ранее подготовленный SQL-запрос. Возвращает true при успешном выполнении запроса; в противном случае возвращает false.

Обратите внимание, что последняя ошибка для этого запроса сбрасывается при вызове exec().

См. также prepare(), bindValue(), addBindValue(), boundValue() и boundValues().

bool QSqlQuery::execBatch(QSqlQuery::BatchExecutionMode mode = ValuesAsRows)

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

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

Пример:

QSqlQuery q;
q.prepare("insert into myTable values (?, ?)");

QVariantList ints;
ints << 1 << 2 << 3 << 4;
q.addBindValue(ints);

QVariantList names;
names << "Harald" << "Boris" << "Trond" << QVariant(QVariant::String);
q.addBindValue(names);

if (!q.execBatch())
    qDebug() << q.lastError();

В приведенном выше примере вставляются четыре новые строки в myTable.

1  Harald
2  Boris
3  Trond
4  NULL

Для привязки значений NULL необходимо добавить нулевую QVariant соответствующего типа в привязанный QVariantList; например, QVariant(QVariant::String) следует использовать при работе со строками.

Примечание: Каждый привязанный QVariantList должен содержать одинаковое количество вариантов.

Примечание: Тип QVariants в списке не должен изменяться. Например, вы не можете смешивать целочисленные и строковые варианты в одном QVariantList.

Параметр mode указывает, как будет интерпретироваться привязанный QVariantList. Если mode равен ValuesAsRows, каждый вариант в QVariantList будет интерпретирован как значение для новой строки. ValuesAsColumns — специальный случай для Oracle-драйвера. В этом режиме каждый элемент в QVariantList будет интерпретирован как значение массива для значения IN или OUT в хранимой процедуре. Обратите внимание, что это будет работать только в том случае, если значение IN или OUT является табличным типом, состоящим только из одного столбца базового типа, например, TYPE myType IS TABLE OF VARCHAR(64) INDEX BY BINARY_INTEGER;.

Эта функция была введена в Qt 4.2.

См. также prepare(), bindValue() и addBindValue().

QString QSqlQuery::executedQuery() const

Возвращает последний успешно выполненный запрос.

В большинстве случаев эта функция возвращает ту же строку, что и lastQuery(). Если подготовленный запрос с плейсхолдерами выполняется на СУБД, которая его не поддерживает, подготовка этого запроса эмулируется. Плейсхолдеры в исходном запросе заменяются их связанными значениями, чтобы сформировать новый запрос. Эта функция возвращает измененный запрос. Она в основном полезна для отладки.

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

void QSqlQuery::finish()

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

Устанавливает запрос в неактивное состояние. Привязанные значения сохраняются.

Эта функция была введена в Qt 4.3.2.

См. также prepare(), exec() и isActive().

bool QSqlQuery::first()

Извлекает первую запись в результате, если она доступна, и позиционирует запрос на извлеченной записи. Обратите внимание, что результат должен находиться в активном состоянии, и isSelect() должен возвращать true перед вызовом этой функции, иначе она ничего не сделает и вернёт false. Возвращает true при успехе. В случае неудачи позиция запроса устанавливается в недействительную позицию, и возвращается false.

См. также next(), previous(), last(), seek(), at(), isActive() и isValid().

bool QSqlQuery::isActive() const

Возвращает true если запрос активен. Активный QSqlQuery — это запрос, который был успешно выполнен exec(), но ещё не завершен. После завершения работы с активным запросом вы можете сделать запрос неактивным, вызвав finish() или clear(), или вы можете удалить экземпляр QSqlQuery.

Примечание: Особый интерес представляет активный запрос, который является SELECT утверждением. В некоторых базах данных, поддерживающих транзакции, активный запрос, являющийся SELECT утверждением, может привести к тому, что commit() или rollback() потерпят неудачу, поэтому перед подтверждением или откатом вы должны сделать ваш активный SELECT запрос неактивным, используя один из перечисленных выше способов.

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

bool QSqlQuery::isForwardOnly() const

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

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

bool QSqlQuery::isNull(int field) const

Возвращает true если запрос не активен, запрос не расположен на действительной записи, такого поля field нет или поле field равно null; в противном случае false. Обратите внимание, что для некоторых драйверов isNull() не будет возвращать точную информацию до тех пор, пока не будет произведена попытка извлечения данных.

См. также isActive(), isValid() и value().

bool QSqlQuery::isNull(const QString &name) const

Это перегруженная функция.

Возвращает true если поля с таким именем name нет; в противном случае возвращает isNull(int index) для соответствующего индекса поля.

Этот перегруз менее эффективен, чем isNull()

bool QSqlQuery::isSelect() const

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

bool QSqlQuery::isValid() const

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

bool QSqlQuery::last()

Извлекает последнюю запись в результате, если она доступна, и позиционирует запрос на извлеченной записи. Обратите внимание, что результат должен находиться в активном состоянии, и isSelect() должен возвращать true перед вызовом этой функции, иначе она ничего не сделает и вернёт false. Возвращает true при успехе. В случае неудачи позиция запроса устанавливается в недействительную позицию, и возвращается false.

См. также next(), previous(), first(), seek(), at(), isActive() и isValid().

QSqlError QSqlQuery::lastError() const

Возвращает информацию об ошибке последней ошибки (если она есть), которая произошла с этим запросом.

См. также QSqlError и QSqlDatabase::lastError().

QVariant QSqlQuery::lastInsertId() const

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

Для баз данных MySQL будет возвращено поле автоинкремента строки.

Примечание: Для работы этой функции в PSQL таблица должна содержать OIDs, которые могут быть не созданы по умолчанию. Проверьте переменную конфигурации default_with_oids.

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

QString QSqlQuery::lastQuery() const

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

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

bool QSqlQuery::next()

Извлекает следующую запись в результате, если она доступна, и позиционирует запрос на извлечённую запись. Обратите внимание, что результат должен быть в состоянии активный и isSelect() должен возвращать true перед вызовом этой функции, иначе она ничего не сделает и вернёт false.

Применяются следующие правила:

• Если результат в настоящее время расположен перед первой записью, например, сразу после выполнения запроса, выполняется попытка извлечения первой записи.
• Если результат в настоящее время расположен после последней записи, никаких изменений не происходит, и возвращается false.
• Если результат расположен где-то посередине, выполняется попытка извлечения следующей записи.

Если запись не может быть извлечена, результат позиционируется после последней записи, и возвращается false. Если запись успешно извлечена, возвращается true.

См. также previous(), first(), last(), seek(), at(), isActive() и isValid().

bool QSqlQuery::nextResult()

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

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

Если новый набор результатов доступен, эта функция вернёт true. Запрос будет перепозиционирован на недействительной записи в новом наборе результатов, и необходимо перейти к действительной записи перед получением значений данных. Если новый набор результатов недоступен, функция вернёт false и запрос будет установлен в неактивное состояние. В любом случае старый набор результатов будет отброшен.

Когда один из операторов является оператором, отличным от SELECT, вместо набора результатов может быть доступно количество затронутых строк.

Обратите внимание, что некоторые базы данных, например, Microsoft SQL Server, требуют нескроллируемые курсоры при работе с несколькими наборами результатов. Некоторые базы данных могут выполнить все операторы сразу, в то время как другие могут отложить выполнение до фактического доступа к набору результатов, и некоторые базы данных могут накладывать ограничения на операторы, которые разрешены в SQL-пакете.

Эта функция была представлена в Qt 4.4.

См. также QSqlDriver::hasFeature(), setForwardOnly(), next(), isSelect(), numRowsAffected(), isActive() и lastError().

int QSqlQuery::numRowsAffected() const

Возвращает количество строк, затронутых оператором SQL результата, или -1, если это невозможно определить. Обратите внимание, что для SELECT операторов значение не определено; используйте size() вместо этого. Если запрос не активен, возвращается -1.

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

QSql::NumericalPrecisionPolicy QSqlQuery::numericalPrecisionPolicy() const

Возвращает текущую политику точности.

См. также QSql::NumericalPrecisionPolicy и setNumericalPrecisionPolicy().

bool QSqlQuery::prepare(const QString &query)

Подготавливает SQL-запрос query к выполнению. Возвращает true , если запрос подготовлен успешно; в противном случае возвращает false.

Запрос может содержать плейсхолдеры для привязки значений. Поддерживаются плейсхолдеры в стиле Oracle с двоеточием (например, :surname) и в стиле ODBC (?); но их нельзя смешивать в одном запросе. Примеры см. в Подробном описании.

Примечания по переносимости: Некоторые базы данных выбирают отложить подготовку запроса до первого выполнения. В этом случае подготовка синтаксически неправильного запроса выполняется успешно, но каждый последующий exec() завершится ошибкой. Когда база данных не поддерживает плейсхолдеры с именами напрямую, плейсхолдер может содержать только символы в диапазоне [a-zA-Z0-9_].

Для SQLite строка запроса может содержать только один оператор за раз. Если указано более одного оператора, функция возвращает false.

Пример:

    QSqlQuery query;
    query.prepare("INSERT INTO person (id, forename, surname) "
                  "VALUES (:id, :forename, :surname)");
    query.bindValue(":id", 1001);
    query.bindValue(":forename", "Bart");
    query.bindValue(":surname", "Simpson");
    query.exec();

См. также exec(), bindValue() и addBindValue().

bool QSqlQuery::previous()

Извлекает предыдущую запись в результате, если она доступна, и позиционирует запрос на извлечённую запись. Обратите внимание, что результат должен быть в состоянии активный и isSelect() должен возвращать true перед вызовом этой функции, иначе она ничего не сделает и вернёт false.

Применяются следующие правила:

• Если результат в настоящее время расположен перед первой записью, никаких изменений не происходит, и возвращается false.
• Если результат в настоящее время расположен после последней записи, выполняется попытка извлечения последней записи.
• Если результат расположен где-то посередине, выполняется попытка извлечения предыдущей записи.

Если запись не может быть извлечена, результат позиционируется перед первой записью, и возвращается false. Если запись успешно извлечена, возвращается true.

См. также next(), first(), last(), seek(), at(), isActive() и isValid().

QSqlRecord QSqlQuery::record() const

Возвращает QSqlRecord, содержащий информацию о поле для текущего запроса. Если запрос указывает на действительную строку (isValid() возвращает true), запись заполняется значениями строки. Пустая запись возвращается, когда нет активного запроса (isActive() возвращает false).

Для извлечения значений из запроса следует использовать value(), так как основанный на индексе поиск в нём быстрее.

В следующем примере выполняется запрос SELECT * FROM. Так как порядок столбцов не определён, используется QSqlRecord::indexOf() для получения индекса столбца.

QSqlQuery q("select * from employees");
QSqlRecord rec = q.record();

qDebug() << "Number of columns: " << rec.count();

int nameCol = rec.indexOf("name"); // index of the field "name"
while (q.next())
    qDebug() << q.value(nameCol).toString(); // output all names

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

const QSqlResult *QSqlQuery::result() const

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

bool QSqlQuery::seek(int index, bool relative = false)

Извлекает запись в позиции index, если она доступна, и позиционирует запрос на извлечённую запись. Первая запись находится в позиции 0. Обратите внимание, что запрос должен быть в состоянии активный, а isSelect() должен возвращать true перед вызовом этой функции.

Если relative ложно (по умолчанию), применяются следующие правила:

• Если index отрицательно, результат позиционируется перед первой записью, и возвращается false.
• В противном случае выполняется попытка переместиться в запись с позицией index. Если запись в позиции index не может быть извлечена, результат позиционируется после последней записи, и возвращается false. Если запись успешно извлечена, возвращается true.

Если relative истинно, применяются следующие правила:

• Если результат в настоящее время расположен перед первой записью и:
  • index отрицательно или равно нулю, изменений не происходит, и возвращается false.
  • index положительно, выполняется попытка позиционирования результата в абсолютной позиции index - 1, следуя тем же правилам, что и для не относительного поиска, описанным выше.
• Если результат в настоящее время расположен после последней записи и:
  • index положительно или равно нулю, изменений не происходит, и возвращается false.
  • index отрицательно, выполняется попытка позиционирования результата в позиции index + 1 относительно последней записи, следуя правилу ниже.
• Если результат в настоящее время расположен где-то посередине, и относительное смещение index перемещает результат ниже нуля, результат позиционируется перед первой записью, и возвращается false.
• В противном случае выполняется попытка переместиться в запись на index позиций вперёд от текущей записи (или на index позиций назад от текущей записи, если index отрицательно). Если запись в смещении index не может быть извлечена, результат позиционируется после последней записи, если index >= 0, (или перед первой записью, если index отрицательно), и возвращается false. Если запись успешно извлечена, возвращается true.

См. также next(), previous(), first(), last(), at(), isActive() и isValid().

void QSqlQuery::setForwardOnly(bool forward)

Устанавливает режим только вперёд в forward. Если forward истинно, разрешены только next() и seek() с положительными значениями для навигации по результатам.

Режим только вперёд может быть (в зависимости от драйвера) более эффективным с точки зрения памяти, так как результаты не нужно кэшировать. Он также улучшит производительность на некоторых базах данных. Для этого вы должны вызвать setForwardOnly() перед подготовкой или выполнением запроса. Обратите внимание, что конструктор, принимающий запрос и базу данных, может выполнить запрос.

Режим только вперёд выключен по умолчанию.

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

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

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

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

См. также isForwardOnly(), next(), seek(), и QSqlResult::setForwardOnly().

void QSqlQuery::setNumericalPrecisionPolicy(QSql::NumericalPrecisionPolicy precisionPolicy)

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

Например, драйвер Oracle может извлекать числовые значения в виде строк, чтобы предотвратить потерю точности. Если высокая точность не важна, используйте этот метод для повышения скорости выполнения, минуя преобразования строк.

Примечание: Драйверы, не поддерживающие извлечение числовых значений с низкой точностью, проигнорируют политику точности. Вы можете использовать QSqlDriver::hasFeature(), чтобы узнать, поддерживает ли драйвер эту функцию.

Примечание: Установка политики точности не влияет на активный запрос. Вызовите exec(QString) или prepare(), чтобы активировать политику.

См. также QSql::NumericalPrecisionPolicy и numericalPrecisionPolicy().

int QSqlQuery::size() const

Возвращает размер результата (количество строк), или -1, если размер не может быть определён или если база данных не поддерживает предоставление информации о размерах запроса. Обратите внимание, что для запросов, не являющихся SELECT, (isSelect() возвращает false), size() вернёт -1. Если запрос не активен (isActive() возвращает false), возвращается -1.

Чтобы определить количество строк, затронутых операцией, не являющейся SELECT, используйте numRowsAffected().

См. также isActive(), numRowsAffected(), и QSqlDriver::hasFeature().

QVariant QSqlQuery::value(int index) const

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

Поля нумеруются слева направо с использованием текста SELECT оператора, например, в

SELECT forename, surname FROM people;

поле 0 — forename, а поле 1 — surname. Использование SELECT * не рекомендуется, так как порядок полей в запросе не определён.

Возвращается некорректный QVariant, если поле index не существует, запрос неактивен или запрос расположен на некорректной записи.

См. также previous(), next(), first(), last(), seek(), isActive(), и isValid().

QVariant QSqlQuery::value(const QString &name) const

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

Возвращает значение поля с именем name в текущей записи. Если поле name не существует, возвращается некорректный вариант.

Этот перегруженный метод менее эффективен, чем value()

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

Присваивает other этому объекту.