数据库(SQLITE3函数总结): sqlite3_open, sqlite3_exec, slite3_close,sqlite3_prepare_v2,sqlite3_column_text,

怼烎@ 2023-10-18 14:07 113阅读 0赞

Sqlite3 的确非常好用。小巧、速度快。近期研究它，有一些收获，这里把我对 sqlite3 的研究列出来，以备忘记。

导入SQLLite library并引入头文件.

libsqlite3.dylib本身是个链接，在这里它指向libsqlite3.0.dylib。也就是说在这里你加入libsqlite3.dylib和加入libsqlite3.0.dylib事实上是加入了同一个文件，没有差别，那为什么要加入libsqlite3.0.dylib呢？原因在于libsqlite3.dylib是旧版的sqlite3动态库。也就是说假设出现了新的动态库（如：libsqlite3.1.dylib）那libsqlite3.dylib将指向这个新的动态库（libsqlite3.1.dylib）所以建议还是要加入libsqlite3.0.dylib。

(1) 重要数据结构

sqlite 里最经常使用到的是 sqlite3 \* 类型。

从数据库打开開始，sqlite就要为这个类型准备好内存。直到数据库关闭，整个过程都须要用到这个类型。当数据库打开时開始，这个类型的变量就代表了你要操作的数据库。以下再具体介绍。

#### (2) 打开数据库 ####

打开数据库链接sqlite3\_open使用方法

原型：

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

用这个函数打开数据库操作。

须要传入两个參数，一是数据库文件名称，比方ZUOYOU1314Students.sqlite. 在iOS中通常是\[fileUTF8String\]

NSString \* file = \[documentsPathstringByAppendingPathComponent:@"ZUOYOU1314Students.sqlite"\];

二是 sqlite3 \*\* 參数即前面提到的重要数据结构。这个结构底层细节怎样。你不要管它。函数返回值表示操作是否正确，假设是 SQLITE\_OK 则表示操作正常。相关的返回值sqlite定义了一些宏。

具体这些宏的含义能够參考 sqlite3.h 文件。里面有具体定义.

參考代码例如以下:

//指向数据库的指针
    static sqlite3 * db = nil;
    
    //打开数据库
    + (sqlite3 *)open
    {
        //推断数据库对象是否打开, 即db 是否有值
        if (db != nil) {
            //db有值, 直接使用,不须要再打开
            return db;
        }
        
    #pragma ------第一次实现了拷贝 第二次须要推断documents里面是否已经有数据库文件
        //先找到documents文档
        NSString * documentsPath = kDocuments;
        //在documents 里面 拼接一个目录
        NSString * file = [documentsPath stringByAppendingPathComponent:@"Students.sqlite"];
        //从包里面取到 叫Students名字 后缀是sqlite的文件
        NSString * bundleFile = [[NSBundle mainBundle]pathForResource:@"Students" ofType:@"sqlite"];
        //创建文件管理器
        NSFileManager * fileManager = [NSFileManager defaultManager];
    
    
        
        //推断文件是否存在
        if ([fileManager fileExistsAtPath:file] == NO) {
            
            //然后把包里的文件复制到documents目录里
            [fileManager copyItemAtPath:bundleFile toPath:file error:nil];
            //UTF8tring 会把C语言 转换为 OC字符串    
        }
        sqlite3_open([file UTF8String], &db);
        
        return db;
    }

#### (3) 关闭数据库 ####

原型：

SQLITE_API int sqlite3_close(sqlite3 *);

參考代码例如以下:

/关闭数据库
    + (void)close
    {
        sqlite3_close(db);
        db = nil;    
    }

### (4) SQL语句操作 ###

(一) sqlite3\_exec:

原型：

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 */
    );

这就是运行一条 sql 语句的函数。

第1个參数不再说了，是前面open函数得到的指针。说了是重要数据结构。

第2个參数const char \*sql 是一条 sql 语句。以/0结尾。

第3个參数sqlite3\_callback 是回调，当这条语句运行之后，sqlite3会去调用你提供的这个函数。

第4个參数void \* 是你所提供的指针，你能够传递不论什么一个指针參数到这里，这个參数终于会传到回调函数里面。假设不须要传递指针给回调函数。能够填NULL。等下我们再看回调函数的写法，以及这个參数的使用。

第5个參数char \*\* errmsg 是错误信息。

注意是指针的指针。sqlite3里面有非常多固定的错误信息。

运行 sqlite3\_exec之后，运行失败时能够查阅这个指针（直接 printf(“%s/n”,errmsg)）得到一串字符串信息，这串信息告诉你错在什么地方。sqlite3\_exec函数通过改动你传入的指针的指针，把你提供的指针指向错误提示信息，这样sqlite3\_exec函数外面就能够通过这个 char\*得到详细错误提示。

说明：通常，sqlite3\_callback 和它后面的 void \* 这两个位置都能够填 NULL。

填NULL表示你不须要回调。比方你做 insert 操作，做 delete 操作,做update 操作，就没有必要使用回调。而当你做 select 时，就要使用回调。由于 sqlite3 把数据查出来，得通过回调告诉你查出了什么数据。

參考代码例如以下:

- (void)deleteButton
    {
        //打开数据库
        sqlite3 * db = [DB open];
        //运行删除    
    int falg =  sqlite3_exec(db, "delete from BJS140523 where sName like '坐'", NULL, NULL, nil);
        NSLog(@"444444  falg = %d",falg);
    }

(二 ) sqlite3\_prepare\_v2:

原型：

SQLITE\_API int sqlite3\_prepare\_v2( sqlite3 \*db, /\* Database handle \*/ const char \*zSql, /\* SQL statement, UTF-8 encoded \*/ int nByte, /\* Maximum length of zSql in bytes. \*/ sqlite3\_stmt \*\*ppStmt, /\* OUT: Statement handle \*/

<span style="font-family: 'Comic Sans MS';">   const char **pzTail     /* OUT: Pointer to unused portion of zSql */</span>

參考代码例如以下:

int flag =sqlite3\_prepare\_v2(db, "select \* from BJS140523 " , -1, &stmt, nil);  
(三) 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);

參考代码例如以下:

int sID = sqlite3\_column\_int(stmt, 0);//列的编号从0開始 const unsigned char \* sName = sqlite3\_column\_text(stmt, 1); int sAge = sqlite3\_column\_int(stmt, 2); const unsigned char \* sSex = sqlite3\_column\_text(stmt, 3);

(四)sqlite3\_step()

原型：

SQLITE\_API int sqlite3\_step(sqlite3\_stmt\*);  
參考代码例如以下:  
if (falg == SQLITE\_OK) \{ sqlite3\_step(stmt); \}  
(五)sqlite3\_finalize()

原型：

SQLITE\_API int sqlite3\_finalize(sqlite3\_stmt \*pStmt);

參考代码例如以下:

sqlite3\_finalize(stmt);

(六) sqlite3\_bind\_text

//bind 绑定

原型：

SQLITE\_API int sqlite3\_bind\_blob(sqlite3\_stmt\*, int, const void\*, int n, void(\*)(void\*)); SQLITE\_API int sqlite3\_bind\_double(sqlite3\_stmt\*, int, double); SQLITE\_API int sqlite3\_bind\_int(sqlite3\_stmt\*, int, int); SQLITE\_API int sqlite3\_bind\_int64(sqlite3\_stmt\*, int, sqlite3\_int64); SQLITE\_API int sqlite3\_bind\_null(sqlite3\_stmt\*, int); SQLITE\_API int sqlite3\_bind\_text(sqlite3\_stmt\*, int, const char\*, int n, void(\*)(void\*)); SQLITE\_API int sqlite3\_bind\_text16(sqlite3\_stmt\*, int, const void\*, int, void(\*)(void\*)); SQLITE\_API int sqlite3\_bind\_value(sqlite3\_stmt\*, int, const sqlite3\_value\*); SQLITE\_API int sqlite3\_bind\_zeroblob(sqlite3\_stmt\*, int, int n);

參考代码例如以下:

int falg = sqlite3\_prepare\_v2(db, "update BJS140523 set sSex = ?,sAge = ?where sID = ?", -1, &stmt, nil); //绑定 //问号是从 1 開始的 sqlite3\_bind\_text(stmt,1,\[sex UTF8String\], -1, NULL); sqlite3\_bind\_int(stmt, 2, age); sqlite3\_bind\_int(stmt, 3, sID);