Class mgr db::Query

Материал из ISPWiki
Перейти к: навигация, поиск

Работа с базами данных

Класс mgr_db::Query

Данный класс является абстрактным

Представление запроса к базе данных

#include <mgrdb.h> 

Описание:

class mgr_db::Query

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

Warning: В случае, если результат запроса не содержит строк, обращение к данным методам является ошибкой программирования

Потомки:


Открытые члены (кратко)

Query ( Connection * )

Конструктор, принимает указатель на подключение к БД, выполняет запрос к БД


virtual  ~Query ()

Деструктор


virtual bool Eof ()=0

Возвращает признак конца результата запроса


virtual bool Next ()=0

Осуществляет переход к следующей строке результата запроса


virtual bool First ()=0

Осуществляет переход к первой строке результата запроса


virtual size_t ColCount ()=0

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

Методы работы со сторокой результата запроса

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

Warning: В случае, если результат запроса не содержит строк, обращение к данным методам является ошибкой программирования

virtual string AsString ( size_t id )

Возвращает значение поля в виде строки (по номеру поля)


virtual int AsInt ( size_t id )

Возвращает значение поля в виде целого числа (по номеру поля)


virtual long long AsLong ( size_t id )

Возвращает значение поля в виде целого числа большой длины (по номеру поля)


virtual double AsDouble ( size_t id )

Возвращает значение поля в виде числа с плавающей точкой (по номеру поля)


virtual bool IsNull ( size_t id )

Возвращает true, если в поле с переданным номером содержится Null-значение, false в противном случае


virtual string ColName ( size_t id )

Возвращает имя поля в результате запроса (по номеру поля)


size_t ColId ( const string &name )

Возвращает номер поля в результате запроса (по имени поля)


string AsString ( const string &name )

Возвращает значение поля в виде строки (по имени поля)


int AsInt ( const string &name )

Возвращает значение поля в виде целого числа (по имени поля)


long long AsLong ( const string &name )

Возвращает значение поля в виде целого числа большой длины (по имени поля)


double AsDouble ( const string &name )

Возвращает значение поля в виде числа с плавающей точкой (по имени поля)


bool IsNull ( const string &name )

Возвращает true, если в поле с переданным именем содержится Null-значение, false в противном случае


string Str ()

Возвращает значение первого поля в виде строки


operator string ()

Возвращает значение первого поля в виде строки


int Int ()

Возвращает значение первого поля в виде целого числа


string operator[] ( const string &name )

Возвращает значение поля в виде строки (по имени поля)


string operator[] ( size_t id )

Возвращает значение поля в виде строки (по номеру поля)

Конструкторы

Query ( Connection * )

Конструктор, принимает указатель на подключение к БД, выполняет запрос к БД

virtual ~Query ()

Деструктор

Методы

virtual string AsString ( size_t id )

Возвращает значение поля в виде строки (по номеру поля)

virtual int AsInt ( size_t id )

Возвращает значение поля в виде целого числа (по номеру поля)

virtual long long AsLong ( size_t id )

Возвращает значение поля в виде целого числа большой длины (по номеру поля)

virtual double AsDouble ( size_t id )

Возвращает значение поля в виде числа с плавающей точкой (по номеру поля)

virtual bool IsNull ( size_t id )

Возвращает true, если в поле с переданным номером содержится Null-значение, false в противном случае

virtual string ColName ( size_t id )

Возвращает имя поля в результате запроса (по номеру поля)

size_t ColId ( const string &name )

Возвращает номер поля в результате запроса (по имени поля)

string AsString ( const string &name )

Возвращает значение поля в виде строки (по имени поля)

int AsInt ( const string &name )

Возвращает значение поля в виде целого числа (по имени поля)

long long AsLong ( const string &name )

Возвращает значение поля в виде целого числа большой длины (по имени поля)

double AsDouble ( const string &name )

Возвращает значение поля в виде числа с плавающей точкой (по имени поля)

bool IsNull ( const string &name )

Возвращает true, если в поле с переданным именем содержится Null-значение, false в противном случае

string Str ()

Возвращает значение первого поля в виде строки

operator string ()

Данная функция/метод является inline функцией

Возвращает значение первого поля в виде строки

int Int ()

Возвращает значение первого поля в виде целого числа

string operator[] ( const string &name )

Возвращает значение поля в виде строки (по имени поля)

string operator[] ( size_t id )

Данная функция/метод является inline функцией

Возвращает значение поля в виде строки (по номеру поля)

virtual bool Eof ()=0

Возвращает признак конца результата запроса

virtual bool Next ()=0

Осуществляет переход к следующей строке результата запроса

virtual bool First ()=0

Осуществляет переход к первой строке результата запроса

Warning: В случае выполнения запросов типа "EXEC" в СУБД MSSQL Server обход результатов запроса выполняется с помощью однонаправленного курсора. В таком случае данный метод используется ТОЛЬКО для перехода к следующему результирующему набору данных (для процедур, возвращающих более одного набора данных)

virtual size_t ColCount ()=0

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