[原]SQLite的学习系列之获取数据库版本二

本系列文章主要是使用C++语言来调用其API,达到管中窥豹的目的。另外本文使用的开发环境为mac + clion,并且基于SQLite 3.7.14来进行开发.

  一、去下载sqlite-amalgamation-3071400.zip,然后解压到文件夹(其结构目录树如下):

    .

    ├── shell.c

    ├── sqlite3.c

    ├── sqlite3.h

    └── sqlite3ext.h

 

  二、新建一个sql_tutorial的工程,景sqlite3.c和sqlite3.h文件拷贝到sql_src目录下:

    .

    ├── main.cpp

    └── sql_src

        ├── sqlite3.c

        └── sqlite3.h

 

  

  三、在main.cpp中调用sqlite的代码如下:

    

/**
 * We get the version of the SQLite database. This time we will use an SQL query.
 */
#include <iostream>
#include "./sql_src/sqlite3.h"

using namespace std;

int main() {
    sqlite3 *db;
    sqlite3_stmt *res;

    const char *file = "test.db";
    int rc = sqlite3_open(file, &db);

    if (rc != SQLITE_OK) {
        cout << "Cannot open database: " << sqlite3_errmsg(db) << endl;
        sqlite3_close(db);

        exit(1);
    }

    rc = sqlite3_prepare_v2(db, "SELECT SQLITE_VERSION()", -1, &res, 0);
    if (rc != SQLITE_OK) {
        cout << "Failed to fetch data: " << sqlite3_errmsg(db) << endl;
        sqlite3_close(db);
        exit(1);
    }

    rc = sqlite3_step(res);

    if (rc == SQLITE_ROW) {
        cout << sqlite3_column_text(res, 0) << endl;
    }

    sqlite3_finalize(res);
    sqlite3_close(db);
    return 0;
}

  四、最后的运行结果如下:

  

3.7.14

Process finished with exit code 0

  

  调用分析:

sqlite3 *db;

  1、该sqlite3的结构定义了一个数据库句柄。每个打开的SQLite数据库是由数据库句柄表示。

 

sqlite3_stmt *res;

  2、该sqlite3_stmt结构代表一个SQL语句。

 

int rc = sqlite3_open(file, &db);

  3、该sqlite3_open()函数打开一个新的数据库连接。其参数是数据库名称和数据库句柄。在“test.db的”是采用了特殊的数据库名称导致打开一个内存数据库。函数的返回码指示数据库是否被成功打开。当连接成功建立,则返回SQLITE_OK。

 

if (rc != SQLITE_OK) {
        cout << "Cannot open database: " << sqlite3_errmsg(db) << endl;
        sqlite3_close(db);

        exit(1);
    }

  4、如果返回代码指示错误,我们打印邮件到控制台,关闭数据库处理,并终止该计划。该sqlite3_errmsg()函数返回错误的描述。它是否被打开时发生错误,与数据库连接句柄相关联的资源,应通过使其向sqlite3_close()函数释放。

 

rc = sqlite3_prepare_v2(db, "SELECT SQLITE_VERSION()", -1, &res, 0);
    if (rc != SQLITE_OK) {
        cout << "Failed to fetch data: " << sqlite3_errmsg(db) << endl;
        sqlite3_close(db);
        exit(1);
    }

  5、执行SQL语句之前,必须调用首先被编译成字节代码的sqlite3_prepare功能之一。 (该sqlite3_prepare()函数被弃用。)

  sqlite3_prepare_v2()函数有五个参数。

  第一个参数是从所述sqlite3_open()函数获得的数据库句柄。

  第二个参数是要编译的SQL语句。

  第三个参数为以字节为单位的SQL语句的最大长度。传递-1会导致读取SQL字符串到第一个零终止子字符串结束了。根据该文件,可以通过传递提供的SQL字符串的字节的确切数量获得一些小的性能优势。

  第四个参数是语句句柄。这将指向预编译的语句,如果sqlite3_prepare_v2()成功运行

  最后一个参数是一个指向SQL语句的未使用的部分。只有SQL字符串的第一个语句被编译,所以参数指向剩下什么未编译。我们传入0,因为该参数对我们不是很重要。

  如果成功,sqlite3_prepare_v2()返回SQLITE_OK;否则错误代码返回

 

  

rc = sqlite3_step(res);

  6、调用sqlite3_step()运行SQL语句。 SQLITE_ROW返回码表示有另一行准备。我们的SQL语句返回只有一行数据,因此,我们调用这个函数一次。

  

sqlite3_finalize(res);

  7、该sqlite3_finalize()函数销毁准备语句对象。

 

sqlite3_close(db);

  8、该sqlite3_close()函数关闭数据库连接。

  

 

你可能感兴趣的:([原]SQLite的学习系列之获取数据库版本二)