sqlite3学习笔记

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//降序