sqlite3基础

要使用sqlite，首先需要添加库文件libsqlite3.dylib。当你搜索libsqlite3关键字时，会发现还有一个libsqlite3.0.dylib的库文件，这里还是建议添加libsqlite3.dylib，原因在于libsqlite3.dylib是一个替身文件，它总是指向最新的sqlite3动态库；假如出现了新的动态库libsqlite3.1.dylib，那么libsqlite3.dylib将指向它，而libsqlite3.0.dylib无法指向。

在对sqlite数据库进行操作前先声明一个sqlite3类型的对象：

sqlite3 *db;

sqlite3_open — 创建并打开一个sqlite数据库

SQLITE_API int sqlite3_open(
  const char *filename,   /* Database filename (UTF-8) */
  sqlite3 **ppDb          /* OUT: SQLite db handle */
);

sqlite3_close — 关闭一个sqlite数据库

SQLITE_API int sqlite3_close(sqlite3*);

示例1：创建并打开sqlite数据库

NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *documentsPath = [paths objectAtIndex:0];
NSLog(@"documentsPath: %@",documentsPath);

NSString *databasePath = [documentsPath stringByAppendingPathComponent:@"personinfo.sqlite"];
NSLog(@"databasePath: %@",databasePath);

int state = sqlite3_open([databasePath UTF8String], &db);
NSLog(@"%d",state);

if(state != SQLITE_OK) {
    sqlite3_close(db);
    NSLog(@"数据库打开失败");
}

sqlite3_exec — 执行非查询的sql语句

SQLITE_API int sqlite3_exec(
  sqlite3*,                                  /* An open database */
  const char *sql,                           /* SQL to be evaluated */
  int (*callback)(void*,int,char**,char**),  /* Callback function */
  void *,                                    /* 1st argument to callback */
  char **errmsg                              /* Error msg written here */
);

示例2：执行创建表、插入数据操作

- (BOOL)execSql:(NSString *)sql {
    char *err;
    if (sqlite3_exec(db, [sql UTF8String], NULL, NULL, &err) != SQLITE_OK) {
        sqlite3_close(db);
        NSLog(@"execute sql fail!");
        return NO;
    }
    else {
        NSLog(@"execute sql succeed!");
        return YES;
    }
}

- (IBAction)createTable:(id)sender {
    NSLog(@"button clicked");
    NSString *strSql = @"CREATE TABLE IF NOT EXISTS PERSONINFO (ID INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, age INTEGER, address TEXT)";
    
    [self execSql:strSql];
}

- (IBAction)insertAction:(id)sender {
    NSLog(@"insert action");
    NSString *sql1 = [NSString stringWithFormat:
                      @"INSERT INTO 'PERSONINFO' ('name', 'age', 'address') VALUES ('%@', '%@', '%@')",
                      @"张三", @"23", @"西城区"];
    
    NSString *sql2 = [NSString stringWithFormat:
                      @"INSERT INTO 'PERSONINFO' ('name', 'age', 'address') VALUES ('%@', '%@', '%@')",
                      @"老六", @"20", @"东城区"];
    [self execSql:sql1];
    [self execSql:sql2];
}

sqlite3_stmt — 相当于ODBC的command对象，用于保存编译好的sql语句

sqlite3_prepare_v2 — 这个函数将sql文本转换成一个准备语句(prepared statement)对象，同时返回这个对象的指针。它实际上并不执行这个sql语句，仅仅为执行而准备这个sql语句，也就是说，在调用该函数成功(SQLITE_OK)后，sqlite3_stmt将不再为空对象。

SQLITE_API int sqlite3_prepare_v2(
  sqlite3 *db,            /* Database handle(数据库指针) */
  const char *zSql,       /* SQL statement, UTF-8 encoded(使用UTF-8编码的SQL语句) */
  int nByte,              /* Maximum length of zSql in bytes.(如果nByte小于0，则函数取出zSql中从开始到第一个0终止符的内容；如果nByte为非负数，那么它就是这个函数能从zSql中读取的最大字节数。如果nBytes为非负数，zSql在第一次遇见/000或u000的时候终止) */
  sqlite3_stmt **ppStmt,  /* OUT: Statement handle(能够使用sqlite3_step()执行的编译好的准备语句的指针，如果错误发生，它被置为NULL，例如输入一个不正确的sql语句。调用过程必须负责在编译好的sql语句完成使用后，调用sqlite3_finalize()删除它。 */
  const char **pzTail     /* OUT: Pointer to unused portion of zSql(当zSql在遇见终止符或者达到设定的nByte结束后，如果还有剩余的内容，那么这些剩余的内容将被存放到pzTail中，不包含终止符) */
);

sqlite3_step — 执行由sqlite3_prepare创建的准备语句。当调用后返回SQLITE_ROW，则代表还有更多行，可继续调用sqlite3_step直至返回SQLITE_DONE。对于insert、update或delete语句，也可以用sqlite3_step来执行，但更推荐用sqlite3_exec。

SQLITE_API int sqlite3_step(sqlite3_stmt*);

sqlite3_step的返回值取决于创建sqlite3_stmt参数所使用的函数，假如使用老版本的接口sqlite3_prepare()或sqlite3_prepare16()，返回值会是SQLITE_BUSY、SQLITE_DONE， SQLITE_ROW， SQLITE_ERROR 或 SQLITE_MISUSE；而v2版本的接口sqlite3_prepare_v2()和sqlite3_prepare16_v2()除了这些值以外，还可能返回扩展状态码。

sqlite3_reset — 重置一个准备语句(prepared statement)对象到它的初始状态，准备被重新执行。在V3.6.23.1以后，sqlite3_step()将会自动调用sqlite3_reset。

SQLITE_API int sqlite3_reset(sqlite3_stmt *pStmt);

sqlite3_finalize — 销毁一个准备语句(prepared statement)对象，在需要时执行这个销毁函数以防止内存泄露。在准备语句对象为空指针时调用这个函数也没有什么影响。

SQLITE_API int sqlite3_finalize(sqlite3_stmt *pStmt);

示例3：利用sqlite3_step执行更新操作 

- (IBAction)updateAction:(id)sender {
    NSString *sqlQuery = @"update PERSONINFO set address='成都市' where age='20'";

    sqlite3_stmt *statement;
    
    if(sqlite3_prepare_v2(db, [sqlQuery UTF8String], -1, &statement, nil) == SQLITE_OK) {
        if(sqlite3_step(statement) == SQLITE_DONE) {
            NSLog(@"update succeed");
        }
        else {
            NSLog(@"update failed");
        }
    }
    sqlite3_finalize(statement);
}

sqlite3_column — 并不存在sqlite3_column这个函数，它只是一个前缀，下面是相关的具体函数：

SQLITE_API const void *sqlite3_column_blob(sqlite3_stmt*, int iCol);
SQLITE_API int sqlite3_column_bytes(sqlite3_stmt*, int iCol);
SQLITE_API int sqlite3_column_bytes16(sqlite3_stmt*, int iCol);
SQLITE_API double sqlite3_column_double(sqlite3_stmt*, int iCol);
SQLITE_API int sqlite3_column_int(sqlite3_stmt*, int iCol);
SQLITE_API sqlite3_int64 sqlite3_column_int64(sqlite3_stmt*, int iCol);
SQLITE_API const unsigned char *sqlite3_column_text(sqlite3_stmt*, int iCol);
SQLITE_API const void *sqlite3_column_text16(sqlite3_stmt*, int iCol);
SQLITE_API int sqlite3_column_type(sqlite3_stmt*, int iCol);
SQLITE_API sqlite3_value *sqlite3_column_value(sqlite3_stmt*, int iCol);

上面的函数用来得到结果集当前行中某一列的值，列索引从0开始。

示例4：查询并打印出结果集

- (IBAction)selectAction:(id)sender {
    NSString *sqlQuery = @"SELECT * FROM PERSONINFO";
    sqlite3_stmt *statement;
    
    if (sqlite3_prepare_v2(db, [sqlQuery UTF8String], -1, &statement, nil) == SQLITE_OK) {
        while (sqlite3_step(statement) == SQLITE_ROW) {
            char *cID = (char*)sqlite3_column_text(statement, 0);
            NSString *strID = [[NSString alloc] initWithUTF8String:cID];
            
            char *cName = (char*)sqlite3_column_text(statement, 1);
            NSString *strName = [[NSString alloc] initWithUTF8String:cName];
            
            int age = sqlite3_column_int(statement, 2);
            
            char *cAddress = (char*)sqlite3_column_text(statement, 3);
            NSString *strAddress = [[NSString alloc] initWithUTF8String:cAddress];
            
            NSLog(@"id:%@  name:%@  age:%d  address:%@",strID, strName, age, strAddress);
        }
    }
    sqlite3_finalize(statement);
}