用户手册:http://wenku.baidu.com/view/872d70ece009581b6bd9eb75.html
百科百科:.net php c c++调用实例
SQLite是一个开源的嵌入式关系数据库,SQLite可移植性好,很容易使用,很小,高效而且可靠,占用资源少。
SQLite嵌入到使用它的应用程序中,它们共用相同的进程空间,而不是单独的一个进程。从外部看,它并不像一个RDBMS,但在进程内部,它却是完整的,自包含的数据库引擎。
嵌入式数据库的一大好处就是在你的程序内部不需要网络配置,也不需要管理。因为客户端和服务器在同一进程空间运行。SQLite 的数据库权限只依赖于文件系统,没有用户帐户的概念。SQLite 有数据库级锁定,没有网络服务器。它需要的内存,其它开销很小,适合用于嵌入式设备。你需要做的仅仅是把它正确的编译到你的程序。
2. 术语
Sql语句: 用来操作已打开的数据库的操作语句
3. 常用API使用说明
3.1 所需头文件
#include <sqlite3.h>
3.2 常见API
3.2.1 打开数据库
原型:int sqlite3_open(const char *filename, sqlite3 **ppDb)
功能:打开数据库文件
参数:filename 所要打开的文件名
*ppDb 成功打开文件后用来操作数据库的指针
返回值:SQLITE_OK 表示成功打开文件
其他值 表示打开失败
3.2.2 关闭数据库
原型:int sqlite3_close(sqlite3 * pDb)
功能:打开数据库文件
参数: ppDb 成功打开文件后用来操作数据库的指针
返回值:SQLITE_OK 表示关闭成功
SQLITE_BUSY 表示关闭失败
3.2.3 执行sql语句
原型:int sqlite3_exec(sqlite3* pDb,
Const char *sql, int (*callback)(void*,int,char**,char**),
Void* arg,
功能:执行sql语句
参数: pDb 所要操作数据库的指针
Sql 要执行的sql语句
Callback 执行语句后调用的回调函数指针
arg 传递给回调函数的第一个参数
errmsg 返回的错误信息
返回值:SQLITE_OK 表示关闭成功
SQLITE_BUSY 表示关闭失败
3.2.4 编译sql语句的声明
原型:int sqlite3_prepare (sqlite3* pDb, const char *zSql, int nByte, sqlite3_stmt **ppStmt, const char **pzTail)
功能: 编译要执行sql语句
参数: pDb 所要操作数据库的指针
zSql 要执行的sql语句
nByte sql语句的长度
ppStmt sql语句编译的结果
pzTail 返回的错误信息
返回值:SQLITE_OK 表示关闭成功
SQLITE_BUSY 表示关闭失败
3.2.5 表格行的步进
原型:int sqlite3_step(sqlite3_stmt* pStmt )
功能: 使数据库指针指向下一行
参数: pStmt 数据库指针
返回值:SQLITE_ROW 表示该行不为空
其他 表示该行为空
3.2.6 获取该行的某列的int型数据
原型:int sqlite3_column_int(sqlite3_stmt* pStmt , int iCol)
功能: 获取pStmt所指向的该列的第iCol列int型数据
参数: pStmt 数据库指针
iCol 第几列
3.2.7 获取该行的某列的text型数据
原型: int sqlite3_column_text(sqlite3_stmt* pStmt , int iCol)
功能: 获取pStmt所指向的该列的第iCol列text型数据
参数: pStmt 数据库指针
iCol 第几列
3.2.8 获取该行的某列的blob型数据
原型: int sqlite3_column_blob (sqlite3_stmt* pStmt , int iCol)
功能: 获取pStmt所指向的该列的第iCol列blob型数据
参数: pStmt 数据库指针
iCol 第几列
3.2.9 获取该行的某列的double型数据
原型: int sqlite3_column_double (sqlite3_stmt* pStmt , int iCol)
功能: 获取pStmt所指向的该列的第iCol列double型数据
参数: pStmt 数据库指针
iCol 第几列
3.2.10 释放一个已准备的声明的类
原型: int sqlite3_finalize(sqlite3_stmt *pStmt)
功能: 操作完数据库后调用该函数释放使用的空间
参数: pStmt 数据库指针
返回值:SQLITE_OK 表示关闭成功
SQLITE_BUSY 表示关闭失败
4. 使用实例
#include <sqlite3.h>
#include <stdio.h>
#include <string.h>
//回调函数
int ListTablesName_callback(void *pDB, int argc, char **argv, char **azColName)
{
int ret;
char pSqlQuerySel[128] = "select * from ";
char *pError = NULL;
sqlite3_stmt *pStmt = NULL;
strcat(pSqlQuerySel, argv[0]);
fprintf(stdout, "%s\n", pSqlQuerySel);
//准备读取数据
ret = sqlite3_prepare((sqlite3 *)pDB, pSqlQuerySel, strlen(pSqlQuerySel), &pStmt, (const char**)&pError);
if (ret != SQLITE_OK)
{
fprintf(stderr, "sqlite3_prepare fail\n");
return -1;
}
while (1)
{
ret = sqlite3_step(pStmt); //移动记录集
if (ret != SQLITE_ROW)
break;
fprintf(stdout, "%d ", sqlite3_column_int(pStmt, 0));
fprintf(stdout, "%s \n", sqlite3_column_text(pStmt, 1));
}
return 0;
}
int main()
{
int ret = 0;
sqlite3 *pDB = NULL;
sqlite3_stmt *pStmt = NULL;
char *pError = NULL;
char *pListTablesNameSel = (char*)"SELECT name FROM sqlite_master";//列出所以表名语句
//打开文件
ret = sqlite3_open("test.db", &pDB);
if (ret != SQLITE_OK)
{
fprintf(stderr, "can't open database : %s\n", sqlite3_errmsg(pDB));
sqlite3_close(pDB);
return -1;
}
//查找源文件中所有表名
ret = sqlite3_exec(pDB, pListTablesNameSel, ListTablesName_callback, pDB, &pError);
if (ret != SQLITE_OK)
{
fprintf(stderr, "list table count error: %s", sqlite3_errmsg(pDB));
sqlite3_close(pDB);
return -1;
}
return 0;
}
编译:g++ example.cpp –lsqlite3
注意:这里需要把sqlite的头文件和库包含在环境变量中
5 终端命令行操作数据库
编译完sqlite源码后可以得到一个可以直接操作数据库文件的可执行文件,名字为sqlite3。
下面简单介绍命令行操作数据库的命令
# ./sqlite3 test.db
sqlite> .tables //显示test.db中所有的表
info login
sqlite> .schema //显示test.db中所有的表的建表语句
CREATE TABLE info(id int, name text);
CREATE TABLE login(id int, name text);
sqlite> .schema info //查询某个表的创建语句
CREATE TABLE info(id int, name text);
sqlite> .help //显示所以命令
sqlite> select * from info; //查表语句
1|wang
2|liu
1|zhang
sqlite>.quit //退出操作
sqlite3兼容sql中大部分常用的sql语句,由于sql语句比较多,这里就不一一例举,如果需要了解更加深入,可以上网查询