Класс QSqlRecord

Класс QSqlRecord инкапсулирует запись базы данных. Подробнее...

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

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

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

Класс QSqlRecord инкапсулирует запись базы данных.

Класс QSqlRecord инкапсулирует функциональность и характеристики записи базы данных (обычно строки в таблице или представлении в базе данных). QSqlRecord поддерживает добавление и удаление полей, а также установку и получение значений полей.

Значения полей записи могут быть установлены по имени или номеру с помощью setValue(); если вы хотите установить поле в null, используйте setNull(). Чтобы найти позицию поля по имени, используйте indexOf(), а чтобы найти имя поля по определенной позиции, используйте fieldName(). Используйте field(), чтобы получить объект QSqlField для данного поля. Используйте contains(), чтобы проверить, содержит ли запись определенное имя поля.

При генерации запросов для выполнения в базе данных только те поля, для которых isGenerated() равно true, включаются в сгенерированный SQL.

Запись может иметь поля, добавленные с помощью append() или insert(), замененные с помощью replace() и удаленные с помощью remove(). Все поля могут быть удалены с помощью clear(). Количество полей задается count(); все их значения могут быть очищены (до null) с помощью clearValues().

См. также QSqlField и QSqlQuery::record().

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

QSqlRecord::QSqlRecord()

Конструирует пустую запись.

См. также isEmpty(), append() и insert().

QSqlRecord::QSqlRecord(const QSqlRecord &other)

Конструирует копию other.

QSqlRecord имеет явную поддержку совместного использования. Это означает, что вы можете создавать копии записи за постоянное время.

QSqlRecord::~QSqlRecord()

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

void QSqlRecord::append(const QSqlField &field)

Добавляет копию поля field в конец записи.

См. также insert(), replace() и remove().

void QSqlRecord::clear()

Удаляет все поля записи.

См. также clearValues() и isEmpty().

void QSqlRecord::clearValues()

Очищает значения всех полей в записи и устанавливает каждое поле в null.

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

bool QSqlRecord::contains(const QString &name) const

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

int QSqlRecord::count() const

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

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

QSqlField QSqlRecord::field(int index) const

Возвращает поле по позиции index. Если index выходит за пределы допустимых значений, функция возвращает значение по умолчанию.

QSqlField QSqlRecord::field(const QString &name) const

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

Возвращает поле с именем name.

QString QSqlRecord::fieldName(int index) const

Возвращает имя поля по позиции index. Если поле не существует, возвращается пустая строка.

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

int QSqlRecord::indexOf(const QString &name) const

Возвращает позицию поля с именем name в записи, или -1, если поле не найдено. Имена полей нечувствительны к регистру. Если совпадает несколько полей, возвращается первое.

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

void QSqlRecord::insert(int pos, const QSqlField &field)

Вставляет поле field по позиции pos в запись.

См. также append(), replace() и remove().

bool QSqlRecord::isEmpty() const

Возвращает true если в записи нет полей; иначе возвращает false.

См. также append(), insert() и clear().

bool QSqlRecord::isGenerated(const QString &name) const

Возвращает true если запись содержит поле с именем name, и это поле должно быть сгенерировано (по умолчанию); иначе возвращает false.

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

bool QSqlRecord::isGenerated(int index) const

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

Возвращает true если запись содержит поле по позиции index, и это поле должно быть сгенерировано (по умолчанию); иначе возвращает false.

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

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

Возвращает true если поле с именем name имеет значение NULL, или если такого поля нет; иначе возвращает false.

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

bool QSqlRecord::isNull(int index) const

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

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

QSqlRecord QSqlRecord::keyValues(const QSqlRecord &keyFields) const

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

Этот метод был добавлен в Qt 5.1.

void QSqlRecord::remove(int pos)

Удаляет поле по позиции pos. Если pos находится вне диапазона, ничего не происходит.

См. также append(), insert() и replace().

void QSqlRecord::replace(int pos, const QSqlField &field)

Заменяет поле по позиции pos заданным полем field. Если pos находится вне диапазона, ничего не происходит.

См. также append(), insert() и remove().

void QSqlRecord::setGenerated(const QString &name, bool generated)

Устанавливает флаг сгенерированного поля с именем name в значение generated. Если поле не существует, ничего не происходит. Только поля, для которых generated установлено в true, включаются в SQL, генерируемый, например, QSqlQueryModel.

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

void QSqlRecord::setGenerated(int index, bool generated)

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

Устанавливает флаг сгенерированного поля с индексом index в значение generated.

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

void QSqlRecord::setNull(int index)

Устанавливает значение поля с индексом index в NULL. Если поле не существует, ничего не происходит.

См. также isNull() и setValue().

void QSqlRecord::setNull(const QString &name)

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

Устанавливает значение поля с именем name в NULL. Если поле не существует, ничего не происходит.

void QSqlRecord::setValue(int index, const QVariant &val)

Устанавливает значение поля по позиции index в значение val. Если поле не существует, ничего не происходит.

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

void QSqlRecord::setValue(const QString &name, const QVariant &val)

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

Устанавливает значение поля с именем name в значение val. Если поле не существует, ничего не происходит.

QVariant QSqlRecord::value(int index) const

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

См. также setValue(), fieldName() и isNull().

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

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

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

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

bool QSqlRecord::operator!=(const QSqlRecord &other) const

Возвращает true если этот объект не идентичен other; иначе возвращает false.

См. также operator==().

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

Устанавливает запись равной other.

QSqlRecord использует неявное совместное использование. Это означает, что вы можете создавать копии записи за постоянное время.

bool QSqlRecord::operator==(const QSqlRecord &other) const

Возвращает true если этот объект идентичен other (т.е. имеет те же поля в том же порядке); иначе возвращает false.

См. также operator!=().