一、简单说明
1.打开数据库
int sqlite3_open(
const char *filename, // 数据库的⽂文件路径
); 3.检查SQL语句的合法性(查询前的准备) int sqlite3_prepare_v2(
);
// 数据库实例
sqlite3 **ppDb
); 2.执⾏行任何SQL语句 int sqlite3_exec(
sqlite3*,
const char *sql,
int (*callback)(void*,int,char**,char**), // SQL语句执⾏行完毕后的回调 void *, // 回调函数的第1个参数
char **errmsg // 错误信息
// ⼀一个打开的数据库实例 // 需要执⾏行的SQL语句
// 数据库实例
// 需要检查的SQL语句
sqlite3 *db,
const char *zSql,
int nByte,
sqlite3_stmt **ppStmt, // sqlite3_stmt实例,⽤用来获得数据库数据 const char **pzTail
// SQL语句的最⼤大字节长度
4.查询⼀一⾏行数据
int sqlite3_step(sqlite3_stmt*); // 如果查询到⼀一⾏行数据,就会返回SQLITE_ROW
5.利⽤用stmt获得某⼀一字段的值(字段的下标从0开始)
double sqlite3_column_double(sqlite3_stmt*, int iCol); // 浮点数据
int sqlite3_column_int(sqlite3_stmt*, int iCol); // 整型数据
sqlite3_int64 sqlite3_column_int64(sqlite3_stmt*, int iCol); // 长整型数据
const void *sqlite3_column_blob(sqlite3_stmt*, int iCol); // ⼆二进制⽂文本数据
const unsigned char *sqlite3_column_text(sqlite3_stmt*, int iCol); // 字符串数据
二、SQLite编码
1.创建、打开、关闭数据库
创建或打开数据库
// path是数据库⽂文件的存放路径
sqlite3 *db = NULL;
int result = sqlite3_open([path UTF8String], &db);
代码解析:
sqlite3_open()将根据⽂文件路径打开数据库,如果不存在,则会创建⼀一个新的数据库。如果result等于常 量SQLITE_OK,则表⽰示成功打开数据库
sqlite3 *db:⼀一个打开的数据库实例 数据库⽂文件的路径必须以C字符串(⽽而⾮非NSString)传⼊入 关闭数据库:sqlite3_close(db); 2.执⾏行不返回数据的SQL语句
执⾏行创表语句
char *errorMsg = NULL; // ⽤用来存储错误信息
char *sql = "create table if not exists t_person(id integer primary key autoincrement, name text, age integer);";
int result = sqlite3_exec(db, sql, NULL, NULL, &errorMsg); 代码解析:
sqlite3_exec()可以执⾏行任何SQL语句,⽐比如创表、更新、插⼊入和删除操作。但是⼀一般不⽤用它执⾏行查询语 句,因为它不会返回查询到的数据
sqlite3_exec()还可以执⾏行的语句: (1)开启事务:begin transaction; (2)回滚事务:rollback; (3)提交事务:commit; 3.带占位符插⼊入数据
char *sql = "insert into t_person(name, age) values(?, ?);"; sqlite3_stmt *stmt;
if (sqlite3_prepare_v2(db, sql, -1, &stmt, NULL) == SQLITE_OK) {
sqlite3_bind_text(stmt, 1, "母鸡", -1, NULL);
sqlite3_bind_int(stmt, 2, 27); }
if (sqlite3_step(stmt) != SQLITE_DONE) { NSLog(@"插⼊入数据错误");
}
sqlite3_finalize(stmt);
代码解析: sqlite3_prepare_v2()返回值等于SQLITE_OK,说明SQL语句已经准备成功,没有语法问题 sqlite3_bind_text():⼤大部分绑定函数都只有3个参数
(1)第1个参数是sqlite3_stmt *类型 (2)第2个参数指占位符的位置,第⼀一个占位符的位置是1,不是0 (3)第3个参数指占位符要绑定的值
(4)第4个参数指在第3个参数中所传递数据的长度,对于C字符串,可以传递-1代替字符串的长度 (5)第5个参数是⼀一个可选的函数回调,⼀一般⽤用于在语句执⾏行后完成内存清理⼯工作 sqlite_step():执⾏行SQL语句,返回SQLITE_DONE代表成功执⾏行完毕 sqlite_finalize():销毁sqlite3_stmt *对象
4.查询数据
char *sql = "select id,name,age from t_person;";
sqlite3_stmt *stmt;
if (sqlite3_prepare_v2(db, sql, -1, &stmt, NULL) == SQLITE_OK) {
while (sqlite3_step(stmt) == SQLITE_ROW) {
int _id = sqlite3_column_int(stmt, 0);
char *_name = (char *)sqlite3_column_text(stmt, 1); NSString *name = [NSString stringWithUTF8String:_name]; int _age = sqlite3_column_int(stmt, 2);
NSLog(@"id=%i, name=%@, age=%i", _id, name, _age);
} }
sqlite3_finalize(stmt);
代码解析:
sqlite3_step()返回SQLITE_ROW代表遍历到⼀一条新记录 sqlite3_column_*()⽤用于获取每个字段对应的值,第2个参数是字段的索引,从0开始