勇芳软件工作室.汉化:  SQLite3 API Functions > Statements >

sqlite3_bind_int64

Previous pageReturn to chapter overviewNext page

描述

 

在SQL语句文本输入到sqlite3_prepare_v2及其变体中,文字可能会被匹配以下模板之一的参数所替代:

 

?

?NNN

:VVV

@VVV

$VVV

 

在上面的模板中,NNN表示一个整数,VVV表示一个字母数字标识符。这些参数(也称为“主机参数名称”或“SQL参数”)的值可以使用sqlite3_bind_*函数进行设置。

 

C / C ++语法

 

int sqlite3_bind_int64(sqlite3_stmt*, int, sqlite3_int64);

 

PB语法

 

FUNCTION sqlite3_bind_int64 ( _

BYVAL hStmt AS DWORD, _

BYVAL idx AS LONG, _

BYVAL qValue AS QUAD _

) AS LONG

 

参数

 

pStmt

 

[in]语句句柄。

 

idx

 

[in]要设置的SQL参数的索引。最左边的SQL参数的索引为1。当使用相同的命名SQL参数多次,第二次和后续出现与第一次出现相同的索引。如果需要,可以使用sqlite3_bind_parameter_indexAPI查找命名参数的索引。“?NNN”参数的索引是NNN的值。NNN值必须介于1和sqlite3_limit参数SQLITE_LIMIT_VARIABLE_NUMBER之间(默认值:999)。

 

qValue

 

[in]绑定到参数的值。

 

返回值

 

SQLITE_OK成功或错误代码如果出现问题。如果参数索引超出范围,则返回SQLITE_RANGE。如果的malloc失败,则返回SQLITE_NOMEM。

 

备注

 

绑定不会被sqlite3_reset功能清除。Unbound参数被解释为NULL。

 

C ++实现代码

 

SQLITE_API int sqlite3_bind_int(sqlite3_stmt *p, int i, int iValue){

return sqlite3_bind_int64(p, i, (i64)iValue);

}

SQLITE_API int sqlite3_bind_int64(sqlite3_stmt *pStmt, int i, sqlite_int64 iValue){

int rc;

Vdbe *p = (Vdbe *)pStmt;

rc = vdbeUnbind(p, i);

if( rc==SQLITE_OK ){

  sqlite3VdbeMemSetInt64(&p->aVar[i-1], iValue);

  sqlite3_mutex_leave(p->db->mutex);

}

return rc;

}