引言
SQLite3 是一款轻量级的嵌入式数据库引擎,以其小巧、高效、零配置等特性在众多项目中广泛应用。在使用 SQLite3 进行数据库操作时,掌握其核心函数是关键。本文将详细介绍 SQLite3 中一些常用函数的功能、使用方法及示例,帮助你轻松开启数据库操作之旅。
一、数据库连接与关闭
1. sqlite3_open
:打开数据库之门
功能
sqlite3_open
函数的主要作用是打开一个 SQLite 数据库文件。若指定的文件不存在,它会自动创建一个新的数据库文件。
原型
int sqlite3_open(const char *filename, sqlite3 **ppDb);
参数解析
filename
:这是要打开的数据库文件的路径。你可以传入绝对路径或相对路径。ppDb
:这是一个指向sqlite3
指针的指针。函数会将打开的数据库连接句柄存储在这个指针所指向的位置,后续的数据库操作都将基于这个句柄进行。
返回值
如果操作成功,函数返回 SQLITE_OK
;若出现错误,则返回相应的错误码。
示例代码
#include <sqlite3.h>
#include <stdio.h>
int main() {
sqlite3 *db;
int rc = sqlite3_open("test.db", &db);
if (rc) {
fprintf(stderr, "无法打开数据库: %s\n", sqlite3_errmsg(db));
return(0);
} else {
fprintf(stdout, "成功打开数据库\n");
}
// 后续操作...
sqlite3_close(db);
return 0;
}
2. sqlite3_close
:关闭数据库通道
功能
当你完成对数据库的操作后,需要使用 sqlite3_close
函数关闭已经打开的数据库连接,释放相关资源。
原型
int sqlite3_close(sqlite3 *db);
参数解析
db
:即之前使用 sqlite3_open
函数打开的数据库连接句柄。
返回值
操作成功返回 SQLITE_OK
,失败则返回错误码。