acl  3.5.3.0
Public 成员函数 | 所有成员列表
acl::db_row类 参考

#include <db_handle.hpp>

+ 类 acl::db_row 继承关系图:
+ acl::db_row 的协作图:

Public 成员函数

 db_row (const std::vector< const char * > &names)
 
 ~db_row (void)
 
const char * field_name (size_t ifield) const
 
const char * field_value (const char *name) const
 
const char * operator[] (const char *name) const
 
const char * field_value (size_t ifield) const
 
const char * operator[] (size_t ifield) const
 
int field_int (size_t ifield, int null_value=0) const
 
int field_int (const char *name, int null_value=0) const
 
long long int field_int64 (size_t ifield, long long int null_value=0) const
 
long long int field_int64 (const char *name, long long int null_value=0) const
 
double field_double (size_t ifield, double null_value=0.0) const
 
double field_double (const char *name, double null_value=0.0) const
 
const char * field_string (size_t ifield) const
 
const char * field_string (const char *name) const
 
size_t field_length (size_t ifield) const
 
size_t field_length (const char *name) const
 
void push_back (const char *value, size_t len)
 
size_t length (void) const
 
void clear (void)
 

额外继承的成员函数

- Protected 成员函数 继承自 acl::acl::noncopyable
 noncopyable ()
 
 ~noncopyable ()
 

详细描述

数据库查询结果集的行记录类型定义

在文件 db_handle.hpp 第 15 行定义.

构造及析构函数说明

◆ db_row()

acl::db_row::db_row ( const std::vector< const char * > &  names)

构造函数

参数
names{const std::vector<const char*>&} 数据库表中字段名列表

◆ ~db_row()

acl::db_row::~db_row ( void  )

成员函数说明

◆ clear()

void acl::db_row::clear ( void  )

清除结果值（即 values_）

◆ field_double() [1/2]

double acl::db_row::field_double ( size_t  ifield,
double  null_value = 0.0 
) const

从查询结果的记录行中取得字段名的浮点类型的字段值

参数
ifield{size_t} 下标值
null_value{double} 当结果为空时，返回此值表示未有相应结果
返回
{double} 当返回值与用户输入的 null_value 值相同时表明没有 查到结果

◆ field_double() [2/2]

double acl::db_row::field_double ( const char *  name,
double  null_value = 0.0 
) const

从查询结果的记录行中取得字段名的浮点类型的字段值

参数
name{const char*} 下标值
null_value{double} 当结果为空时，返回此值表示未有相应结果
返回
{double} 当返回值与用户输入的 null_value 值相同时表明没有 查到结果

◆ field_int() [1/2]

int acl::db_row::field_int ( size_t  ifield,
int  null_value = 0 
) const

从查询结果的记录行中取得对应下标的整数类型的字段值

参数
ifield{size_t} 下标值
null_value{int} 当结果为空时，返回此值表示未有相应结果
返回
{int} 当返回值与用户输入的 null_value 相同表明没有查到结果

◆ field_int() [2/2]

int acl::db_row::field_int ( const char *  name,
int  null_value = 0 
) const

从查询结果的记录行中取得字段名的整数类型的字段值

参数
name{const char*} 下标值
null_value{int} 当结果为空时，返回此值表示未有相应结果
返回
{int} 当返回值与用户输入的 null_value 相同表明没有查到结果

◆ field_int64() [1/2]

long long int acl::db_row::field_int64 ( size_t  ifield,
long long int  null_value = 0 
) const

从查询结果的记录行中取得对应下标的整数类型的字段值

参数
ifield{size_t} 下标值
null_value{acl_int64} 当结果为空时，返回此值表示未有相应结果
返回
{acl_int64} 当返回值与用户输入的 null_value 值相同时表明 没有查到结果

◆ field_int64() [2/2]

long long int acl::db_row::field_int64 ( const char *  name,
long long int  null_value = 0 
) const

从查询结果的记录行中取得字段名的整数类型的字段值

参数
name{const char*} 下标值
null_value{acl_int64} 当结果为空时，返回此值表示未有相应结果
返回
{acl_int64} 当返回值与用户输入的 null_value 值相同时表明 没有查到结果

◆ field_length() [1/2]

size_t acl::db_row::field_length ( size_t  ifield) const

从查询结果的记录行中取得对应下标的字符串类型的字段值长度

参数
ifield{size_t} 下标值
返回
{size_t}

◆ field_length() [2/2]

size_t acl::db_row::field_length ( const char *  name) const

从查询结果的记录行中取得字段名的字符串类型的字段值长度

参数
name{const char*} 下标值
返回
{size_t}

◆ field_name()

const char* acl::db_row::field_name ( size_t  ifield) const

取得数据表中的某个对应下标值的字段名

参数
ifield{size_t} 下标值
返回
{const char*} 返回空说明该下标值越界

◆ field_string() [1/2]

const char* acl::db_row::field_string ( size_t  ifield) const

从查询结果的记录行中取得对应下标的字符串类型的字段值

参数
ifield{size_t} 下标值
返回
{const char*} 当返回值 NULL 时表明没有查到结果

◆ field_string() [2/2]

const char* acl::db_row::field_string ( const char *  name) const

从查询结果的记录行中取得字段名的字符串类型的字段值

参数
name{const char*} 下标值
返回
{const char*} 当返回值 NULL 时表明没有查到结果

◆ field_value() [1/2]

const char* acl::db_row::field_value ( const char *  name) const

从查询结果的记录行中根据字段名取得相应的字段值

参数
name{const char*} 数据表的字段名
返回
{const char*} 对应的字段值，为空则表示字段值不存在或 字段名非法

◆ field_value() [2/2]

const char* acl::db_row::field_value ( size_t  ifield) const

从查询结果的记录行中取得对应下标的字段值

参数
ifield{size_t} 下标值，该值应 < 字段名的个数
返回
{const char*} 对应的字段值，为空则表示下标值非法或 字段值不存在

◆ length()

size_t acl::db_row::length ( void  ) const

行记录中字段值的个数

返回
{size_t}

◆ operator[]() [1/2]

const char* acl::db_row::operator[] ( const char *  name) const

从查询结果的记录行中根据字段名取得相应的字段值， 功能与 field_value 相同

参数
name{const char*} 数据表的字段名
返回
{const char*} 对应的字段值，为空则表示字段值不存在或 字段名非法

◆ operator[]() [2/2]

const char* acl::db_row::operator[] ( size_t  ifield) const

从查询结果的记录行中取得对应下标的字段值，功能与 field_value 相同

参数
ifield{size_t} 下标值，该值应 < 字段名的个数
返回
{const char*} 对应的字段值，为空则表示下标值非法或 字段值不存在

◆ push_back()

void acl::db_row::push_back ( const char *  value,
size_t  len 
)

向记录行添加一个字段值，添加字段值的顺序应该与字段名的顺序一致

参数
value{const char*} 该行记录的某个字段值
len{size_t} value 数据长度
该类的文档由以下文件生成: