描述
在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;
}