sqlite3_stmt
是 SQLite 提供的一个重要的数据结构,它代表一个预备(prepared)的 SQL 语句对象。通过使用 sqlite3_stmt
对象,可以有效地执行 SQL 语句,并在需要时绑定参数和获取结果。
sqlite3_stmt
类似于其他数据库中的语句或预处理对象。它的主要方法有:
sqlite3_prepare_v2()
: 用于将 SQL 语句编译成可执行的字节码。sqlite3_bind()
: 用于绑定参数到 SQL 语句中的变量。sqlite3_step()
: 执行编译后的 SQL 语句。sqlite3_column_()
: 获取结果集中当前行的列值。sqlite3_finalize()
: 释放sqlite3_stmt
对象占用的资源。
下面是一个使用 sqlite3_stmt
的基本示例:
#include <sqlite3.h>
#include <stdio.h>
int main() {
sqlite3 *db;
sqlite3_stmt *res;
char *zErrMsg = 0;
int rc;
rc = sqlite3_open("test.db", &db);
if (rc != SQLITE_OK) {
fprintf(stderr, "Cannot open database: %s\n", sqlite3_errmsg(db));
sqlite3_close(db);
return 1;
}
const char *sql = "INSERT INTO COMPANY (ID, NAME, AGE, ADDRESS, SALARY) "
"VALUES (?, ?, ?, ?, ?);";
rc = sqlite3_prepare_v2(db, sql, -1, &res, 0);
if (rc != SQLITE_OK) {
fprintf(stderr, "Failed to prepare statement: %s\n", zErrMsg);
sqlite3_free(zErrMsg);
sqlite3_close(db);
return 1;
}
// 绑定参数
sqlite3_bind_int(res, 1, 1);
sqlite3_bind_text(res, 2, "Apple Inc.", -1, SQLITE_TRANSIENT);
sqlite3_bind_int(res, 3, 30);
sqlite3_bind_text(res, 4, "1 Infinite Loop Cupertino, CA 95014", -1, SQLITE_TRANSIENT);
sqlite3_bind_double(res, 5, 100000.00);
// 执行语句
rc = sqlite3_step(res);
if (rc == SQLITE_DONE) {
printf("Record created successfully\n");
} else {
fprintf(stderr, "Failed to step: %d\n", rc);
}
sqlite3_finalize(res);
sqlite3_close(db);
return 0;
}
在这个示例中,我们首先打开一个名为 test.db
的数据库,然后准备一个 SQL 插入语句。我们使用 sqlite3_bind
函数来绑定参数到 SQL 语句中的占位符。最后,我们调用 sqlite3_step
来执行语句。如果操作成功,我们会打印一条成功创建记录的消息,如果失败,我们会打印出错误信息。最后,我们释放 sqlite3_stmt
对象并关闭数据库连接。