準(zhǔn)備語句(prepared statement)對象代表一個簡單SQL語句對象的實例,這個對象通常被稱為“準(zhǔn)備語句”或者“編譯好的SQL語句”或者就直接稱為“語句”。
語句對象的生命周期經(jīng)歷這樣的過程:
使用sqlite3_prepare_v2或相關(guān)的函數(shù)創(chuàng)建這個對象
使用sqlite3_bind_*()給宿主參數(shù)(host parameters)綁定值
通過調(diào)用sqlite3_step一次或多次來執(zhí)行這個sql
使用sqlite3——reset()重置這個語句,然后回到第2步,這個過程做0次或多次
使用sqlite3_finalize()銷毀這個對象
static const char *insert = "INSERT INTO xTest(firstValue, secondValue) VALUES (?, ?);";
sqlite3_stmt *stmt;
if (sqlite3_prepare_v2(database, insert, -1, &stmt, NULL) == SQLITE_OK) {
for (int i = 0; i < 1000; ++i) {
sqlite3_bind_int(stmt, 1, i+1);
sqlite3_bind_int(stmt, 2, (i+1) * 2);
if (sqlite3_step(stmt) != SQLITE_DONE) {
--i;
NSLog(@"Error inserting table: %s", sqlite3_errmsg(database));
}
sqlite3_reset(stmt);
}
sqlite3_finalize(stmt);
}
宿主參數(shù)(host parameters)
在傳給sqlite3_prepare_v2()的sql語句文本或者它的變量中,滿足如下模板的文字將被替換成一個參數(shù):
l ?
l ?NNN,NNN代表數(shù)字
l :VVV,VVV代表字符
l @VVV
l $VVV
在上面這些模板中,NNN代表一個數(shù)字,VVV代表一個字母數(shù)字標(biāo)記符(例如:222表示名稱為222的標(biāo)記符),sql語句中的參數(shù)(變量)通過上面的幾個模板來指定,如
“select ? from ? “這個語句中指定了兩個參數(shù),sqlite語句中的第一個參數(shù)的索引值是1,這就知道這個語句中的兩個參數(shù)的索引分別為1和2,使用”?”的話會被自動給予索引值,而使用”?NNN”則可以自己指定參數(shù)的索引值,它表示這個參數(shù)的索引值為NNN。”:VVV”表示一個名為”VVV”的參數(shù),它也有一個索引值,被自動指定。
可以使用sqlite3_bind_*()來給這些參數(shù)綁定值