标签：
要使用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); }
标签：
原文地址：http://www.cnblogs.com/wayne23/p/4803257.html
