sqlite3.hdbhelp.h数据库底层文件

 

添加libsqlite3.0.dylib库
#import “sqlite3.h”

1、打开数据库
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *documentsDirectory = [paths objectAtIndex:0];
NSString *path = [documentsDirectory stringByAppendingPathComponent:@"database_name"];
sqlite3 *database;
if (sqlite3_open([path UTF8String], &database) != SQLITE_OK) {
NSLog(@”创建数据库失败”);
}

2、查询数据库
方法一:
char *errorMsg = NULL;
NSMutableArray* arrayResult = [[NSMutableArray alloc] init];
const char *sql = “SELECT * FROM message WHERE flags=0″;
if (sqlite3_exec(database,sql,processData,(void*)arrayResult,&errorMsg) != SQLITE_OK) {
printf(“查询出错:%s”,errorMsg);
}
processData为回调函数,直接处理完查询后返回的数据
int processData(void* arrayResult,int columnCount,char** columnValue, char** columnName)
{
int i;
NSMutableDictionary* dict = [[NSMutableDictionary alloc] init];
for( i = 0 ; i < columnCount; i ++ )
{
if (columnValue[i]) {
NSString* key = [[NSString alloc] initWithUTF8String:columnName[i]];
NSString* value = [[NSString alloc] initWithUTF8String:columnValue[i]];
[dict setObject:value forKey:key];
}
}
[(NSMutableArray*)arrayResult addObject:dict];
[dict release];
return 0;
}
方法二:
sqlite3_stmt *stmt;
NSString *sql = @”SELECT * FROM table_name WHERE id=? and name=?”;
sqlite3_prepare_v2(database,[sql UTF8String], -1, &stmt, NULL);
// 邦定第一个int参数
sqlite3_bind_int(stmt, 1, 1);
// 邦定第二个字符串参数
sqlite3_bind_text(stmt, 2, [nameString UTF8String], -1, SQLITE_TRANSIENT);
//执行sql文
sqlite3_step(stmt);
//释放sql文资源
sqlite3_finalize(stmt);

3、插入、删除、更新数据库
if(sqlite3_exec(database, [sql UTF8String],0, NULL, &errorMsg) == SQLITE_OK){
printf(“更新表成功”);
}
else {
printf(“更新表失败:%s”,errorMsg);
}

以下演示一下使用sqlite的步骤,先创建一个数据库,然后查询其中的内容。2个重要结构体和5个主要函数:

sqlite3 *pdb, 数据库句柄,跟文件句柄FILE很类似

sqlite3_stmt *stmt, 这个相当于ODBC的Command对象,用于保存编译好的SQL语句

sqlite3_open(), 打开数据库

sqlite3_exec(), 执行非查询的sql语句

sqlite3_prepare(), 准备sql语句,执行select语句或者要使用parameter bind时,用这个函数(封装了sqlite3_exec).

Sqlite3_step(), 在调用sqlite3_prepare后,使用这个函数在记录集中移动。

Sqlite3_close(), 关闭数据库文件

还有一系列的函数,用于从记录集字段中获取数据,如

sqlite3_column_text(), 取text类型的数据。

sqlite3_column_blob(),取blob类型的数据

sqlite3_column_int(), 取int类型的数据

PreparedStatement方式处理SQL请求的过程
特点:可以绑定参数,生成过程。执行的时候像是ADO一样,每次返回一行结果。

1. 首先建立statement对象:
int sqlite3_prepare(
sqlite3 *db,
const char *zSql,
int nBytes,
sqlite3_stmt **ppStmt,
const char **pzTail
);

2. 绑定过程中的参数(如果有没有确定的参数)
int sqlite3_bind_xxxx(sqlite3_stmt*, int, …);
第二个int类型参数-表示参数的在SQL中的序号(从1开始)。
第三个参数为要绑定参数的值。
对于blob和text数值的额外参数:
第四参数是字符串(Unicode 8or16)的长度,不包括结束’\0′。
第五个参数,类型为void(*)(void*),表示SQLite处理结束后用于清理参数字符串的函数。
没有进行绑定的未知参数将被认为是NULL。

3. 执行过程
int sqlite3_step(sqlite3_stmt*);
可能的返回值:
*SQLITE_BUSY: 数据库被锁定,需要等待再次尝试直到成功。
*SQLITE_DONE: 成功执行过程(需要再次执行一遍以恢复数据库状态)
*SQLITE_ROW: 返回一行结果(使用sqlite3_column_xxx(sqlite3_stmt*,, int iCol)得到每一列的结果。
再次调用将返回下一行的结果。
*SQLITE_ERROR: 运行错误,过程无法再次调用(错误内容参考sqlite3_errmsg函数返回值)
*SQLITE_MISUSE: 错误的使用了本函数(一般是过程没有正确的初始化)

4. 结束的时候清理statement对象
int sqlite3_finalize(sqlite3_stmt *pStmt);
应该在关闭数据库之前清理过程中占用的资源。

5. 重置过程的执行
int sqlite3_reset(sqlite3_stmt *pStmt);
过程将回到没有执行之前的状态,绑定的参数不会变化。

其他工具函数
1. 得到结果总共的行数
int sqlite3_column_count(sqlite3_stmt *pStmt);
如果过程没有返回值,如update,将返回0

2. 得到当前行中包含的数据个数
int sqlite3_data_count(sqlite3_stmt *pStmt);
如果sqlite3_step返回SQLITE_ROW,可以得到列数,否则为零。

3. 得到数据行中某个列的数据
sqlite3_column_xxx(sqlite3_stmt*, int iCol);
在sqlite3_step返回SQLITE_ROW后,使用它得到第iCol列的数据。
其中的xxx代表:
blob:指向保存数据内存的指针
bytes, bytes16: 得到该blob类型数据的大小,或者text转换为UTF8/UTF16的字符串长度。
double, int, int64: 数值
text,text16:字符串指针
type:该列的数据类型(SQLITE_INTEGER,SQLITE_FLOAT,SQLITE_TEXT,SQLITE_BLOB,SQLITE_NULL)
注意:如果对该列使用了不同与该列本身类型适合的数据读取方法,得到的数值将是转换过的结果。

4. 得到数据行中某个列的数据的类型
int sqlite3_column_type(sqlite3_stmt*, int iCol);
返回值:SQLITE_INTEGER,SQLITE_FLOAT,SQLITE_TEXT,SQLITE_BLOB,SQLITE_NULL
使用的方法和sqlite3_column_xxx()函数类似。

 

原文地址:https://www.cnblogs.com/wellsoho/p/2626983.html