Класс QSqlRecord

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

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

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

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

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

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

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

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

Записи могут иметь поля, добавленные с помощью 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!=().