c语言 API接口
打开数据库
sqlite3_open_v2() 、sqlite3_open() 、sqlite3_open16()
int sqlite3_open_v2(
const char * filename , //数据库名
sqlite3 * ppDb , //数据库句柄
int flags , //对数据库的操作权限
const char * zVfs //允许调用去重写默认的操作系统接口sqlite3_vfs方法
);
数据库成功打开则返回SQLITE_OK，否则返回错误码。
若数据库不存在，且flags包含SQLITE_OPEN_CREATE，则会创建新数据库。
语句操作
int sqlite3_prepare_v2( //将sql语句转换为准备语句
sqlite3*db, //数据库句柄
const char*zSql, //sql语句
int nByte, //如果nByte小于0，则函数取出zSql中从开始到第一个0终止符的内容；
//如果nByte不是负的，那么它就是这个函数能从zSql中读取的字节数的最大值。
//如果nBytes非负，zSql在第一次遇见’/000/或’u000’的时候终止
sqlite3_stmt **ppStmt, // 返回的状态句柄
const char**pzTail //上面提到zSql在遇见终止符或者是达到设定的nByte之后结束，
//假如zSql还有剩余的内容，那么这些剩余的内容被存放到pZTail中，不包括终止符
);
int sqlite3_exec(
sqlite3 *db, /* An open database 数据库句柄 */
const charchar *sql, /* SQL to be evaluated 要执行的操作 */
int (*callback)(void*,int,char**,char**), /* Callback function 回调函数的指针*/
voidvoid *, /* 1st argument to callback 传给回调函数的参数 */
charchar **errmsg /* Error msg written here 错误信息*/
);
sqlite3_get_table(
sqlite3 *db, /* An open database 数据库句柄*/
const char *zSql, /* SQL to be evaluated 要执行的操作*/
char ***pazResult, /* Results of the query 执行结果，一维数组*/
int *pnRow, /* Number of result rows written here 行数*/
int *pnColumn, /* Number of result columns written here 列数*/
char **pzErrmsg /* Error msg written here 错误信息*/
);
int sqlite3_column_count( //计算prepare函数返回结果的列数
sqlite3_stmt **ppStmt
);
int sqlite3_column_int( //step执行完后的结果集中返回指定列的值
sqlite3_stmt **ppStmt,//状态句柄
int col //想要返回列的索引值
};
int sqlite3_step（ //执行由前面sqlite3_prepare创建的准备语句。
//这个语句执行到结果的第一行可用的位置。
//继续前进到结果的第二行的话，只需再次调用sqlite3_setp()。
//继续调用sqlite3_setp()直到这个语句完成
sqlite3_stmt **ppStmt //prepare返回的状态句柄
）；
int sqlite3_finalize(//销毁前面被sqlite3_prepare创建的准备语句，
//每个准备语句都必须使用这个函数去销毁以防止内存泄露。
sqlite3_stmt *pStmt //prepare返回的状态句柄
);
int sqlite3_reset(
sqlite3_stmt *pStmt //prepare返回的状态句柄
);
//如果之前没有执行sqlite3_step，
//或者执行了之后返回SQLITE_DONE、SQLITE_OK、SQLITE_ROW中的一个
//则调用sqlite3_reset会将stmt返回到prepare刚执行之后的状态
//若调用了step函数并且出错，则使用reset会返回一个错误值
绑定值
（为啥要绑定？）
在一条带参数的prepare之后，step之前，可以给每一个stmt参数绑定一个指定的值。如果一条语句已经调用step执行了，就不能绑定值了，除非这条语句被重置。
一共有9个bind函数，所有这些函数的第1个参数和第2个参数的返回值都是相同的。第一个参数是指向sqlite3_stmt的指针，第二个参数是要绑定的值的索引值，从1开始，第三个参数是要给stmt绑定的值。第四个参数（有的话）代表第三个参数“绑定值”的字节长度。第五个参数（有的话）是指向内存管理回调函数的指针。
以上9个函数，如果执行成功则返回SQLITE_OK，否则返回错误码
int sqlite3_bind_init(sqlite3_stmt *, int, int)//绑定一个32位有符号整型值
int sqlite3_bind_blob(sqlite3_stmt*,const void *,int, void*(void *))
//绑定任意长度的blob类型的二进制数据
//blob：二进制大对象，相当于可以存储大量二进制数据的容器
int sqlite3_bind_text(sqlite3_stmt*, int, const char*, int n, void(*)(void*));
//绑定一个任意长度的UTF-8编码的文本值，第4个参数是字节长度，注意不是字符长度。
//如果给第4个参数传递负值，SQlite就会自动计算绑定值的字节长度（不包括NULL结尾符）
//第五个参数为一个函数指针，SQLITE3执行完操作后回调此函数，通常用于释放字符串占用的内存
//第五个参数为SQLITE_STATIC时，表示绑定的字符串为常量
//第五个参数为SQLITE_TRANSIENT时，表示需要拷贝一份字符串
其他函数见：
https://blog.csdn.net/northcan/article/details/7235519
sqlite操作
PRAGMA语句是SQLITE数据的SQL扩展，是它独有的特性，主要用于修改SQLITE库或者内数据查询的操作
详细用法参见：
http://iihero.iteye.com/blog/1189633
limit
select * from tablename where ... order by ... limit m offset n
select * from tablename where ... order by ... limit n,m
//m表示要显示多少条记录，n表示要跳过多少记录，
//limit 3 offset 5 表示从第6条开始显示3条记录，即第6、7、8条
order by
select * from tablename order by asc//升序
select * from tablename order by desc//降序
网友评论