Windows 中SQLite3 使用（2） -- 基本导出函数

Windows 中SQLite3 使用（2） –- 基本导出函数

 

一、概述

SQLite3 的最常使用基本导出函数有五个：

sqlite3_open：打开（链接到） SQLite3 数据库。

sqlite3_close：关闭 SQLite3 数据库连接。

sqlite3_exec：对于已打开的数据库连接，执行 SQL 语句。

sqlite3_get_table：对于已打开的数据库连接，查询数据库。

sqlite3_free：释放 SQLite 内部分配的内存。

 

二、使用

SQLite3 使用非常简单，像 Windows 大部分 API 一样，先打开对应的资源，获得句柄，然后对资源进行操纵，最后关闭句柄。

下面的代码演示其过程（代码中含有大量注释，具体函数调用过程可看注释）：

#include "stdafx.h"

#include "sqlite3.h"

#include <windows.h>

#pragma comment(lib, "sqlite3.lib")

 

void PrintInfo(LPCSTR* pPrintInfo, int nRows, int nCols)

{

     LPCSTR lpszTemp = NULL;

     for (int nRowIndex = 0; nRowIndex <= nRows; nRowIndex++)     // nRowIndex = 0 时，查找到的是表头

     {

         for (int nColIndex = 0; nColIndex < nCols; nColIndex++)

         {

              lpszTemp = *(pPrintInfo + nRowIndex * nCols + nColIndex);    // 信息是直接累加的，前面是表头

              if (lpszTemp)

              {

                   printf(lpszTemp);

                   printf("/n");

              }

         }

         printf("---------------------------------------/n");

     }

     printf("=======================================================/n");

}

 

void main()

{

     sqlite3* pSQLite = NULL;

     int nRet = 0;

     LPCSTR lpszSQL1 = "create table people(name varchar(20), age int, birthday datetime);";      // 创建表格people 的SQL 语句

     LPCSTR lpszSQL2 = "insert into people values('wang',20,'1990-6-3');";                        // 插入信息的SQL 语句

     LPCSTR lpszSQL3 = "insert into people values('li',21,'1989-3-2');";

     LPCSTR lpszSQL4 = "select * from people;";                                                             // 查找表格people 的所有信息的SQL 语句

     LPCSTR lpszSQL5 = "delete from people where name='wang';";                                        // 删除姓名为"wang" 的信息

     LPSTR* plpszResult = NULL;

     int nRows = 0;

     int nCols = 0;

 

     nRet = sqlite3_open("C://SQLite3_Test.db", &pSQLite);   // 链接到数据库，如果成功，数据库句柄指针存储于pSQLite 中

     if (nRet != SQLITE_OK)                                       // 函数返回SQLITE_OK 表示连接成功，否则直接退出连接

         goto Exit0;

 

     nRet = sqlite3_exec(pSQLite, lpszSQL1, NULL, NULL, NULL);        // 执行SQL 语句，创建people 表

     if (nRet != SQLITE_OK)

         goto Exit0;

 

     nRet = sqlite3_exec(pSQLite, lpszSQL2, NULL, NULL, NULL);        // 执行SQL 语句，将信息插入表格

     if (nRet != SQLITE_OK)

         goto Exit0;

 

     nRet = sqlite3_exec(pSQLite, lpszSQL3, NULL, NULL, NULL);

     if (nRet != SQLITE_OK)

         goto Exit0;

 

     nRet = sqlite3_get_table(pSQLite, lpszSQL4, &plpszResult, &nRows, &nCols, NULL);    // 查询表格中所有信息

     if (nRet != SQLITE_OK)

         goto Exit0;

 

     PrintInfo((LPCSTR*)plpszResult, nRows, nCols); // 输出查询到的信息

 

     nRet = sqlite3_exec(pSQLite, lpszSQL5, NULL, NULL, NULL);    // 删除姓名为"wang" 的信息

     if (nRet != SQLITE_OK)

         goto Exit0;

 

     nRet = sqlite3_get_table(pSQLite, lpszSQL4, &plpszResult, &nRows, &nCols, NULL);

     if (nRet != SQLITE_OK)

         goto Exit0;

 

     PrintInfo((LPCSTR*)plpszResult, nRows, nCols); // 当删除一项后，再打印出数据库中的信息

 

Exit0:

     if (plpszResult)

     {

         if (*plpszResult)

         {

              sqlite3_free(*plpszResult);

              *plpszResult = NULL;

         }

     }

 

     if (pSQLite)

     {

         sqlite3_close(pSQLite);     // 关闭SQLite 数据库连接

         pSQLite = NULL;

     }

     DeleteFile("C://SQLite3_Test.db");   // 删除用于测试的文件

     return;

}

 

三、使用时的线程安全

在 Windows 中，SQLite3 是线程安全的，但使用时也必须遵守规定：一个 sqlite3 结构体指针，只能在一个线程中使用，如果需要将此 sqlite3 结构体传递给其他线程，则必须先复制一份，然后传递。