Класс 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-бекенда с помощью QVariants.

Например:

    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 = QSql::In)

Добавляет значение 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 = QSql::In)

Устанавливает плейсхолдер 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 = QSql::In)

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

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(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 пустое; в противном случае 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 таблица должна содержать OID, что может не быть создано по умолчанию. Проверьте переменную конфигурации default_with_oids , чтобы быть уверенным.

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

QString QSqlQuery::lastQuery() const

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

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

bool QSqlQuery::next()

Получает следующую запись в результате, если она доступна, и позиционирует запрос на полученной записи. Обратите внимание, что результат должен быть в активном состоянии (active) и 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() вместо этого. Если запрос не активен (active), возвращается -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() завершится ошибкой.

Для 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()

Получает предыдущую запись в результате, если она доступна, и позиционирует запрос на полученной записи. Обратите внимание, что результат должен быть в активном состоянии (active) и 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. Обратите внимание, что запрос должен быть в активном состоянии (active) и isSelect() должно возвращать true перед вызовом этой функции.

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

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

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

• Если результат в данный момент расположен перед первой записью и:
  • 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 имеет значение true, разрешены только next() и seek() с положительными значениями для навигации по результатам.

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

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

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

isForwardOnly() всегда вернёт правильное состояние набора результатов.

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

См. также 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 этому объекту.