[译]C/C++用使用SQLITE3及其API接口的基本过程

winston

Sqlite是一个面向嵌入式系统的数据库，编译完成只有200K，同时支持2T的数据记录。对于嵌入式设备是一个很好的数据库引擎。本文通过一个小例子说明如何在C与C＋＋调用Sqlite API完成数据库的创建、插入数据与查询数据。本文的开发环境为（Redhat9.0 + Qtopia2.1.2 + Sqlite3) 安装Sqlite3：
从www.sqlite.org上下载Sqlite3.2.2运源代码，依照Readme中的步骤：
tar xzf sqlite3.2.2.tar.gz
mkdir bld
cd bld
../sqlite3.2.2/configure
make
make install
然后在shell下运行 sqlite3 test.db命令可以检验是否已经安装成功。
创建数据库：

1. sqlite3 *pDB = NULL;
2. char *
3. errMsg =
4. NULL;

复制代码

//打开一个数据库，如果改数据库不存在，则创建一个名字为databaseName的数据库文件

1. int rc = sqlite3_open(databaseName, &pDB);
3.   
4. if(rc)
5.   {
6.     cout << " Open the
7. database " << databaseName << " failed" << endl;
8.   
9. }
11.   //如果创建成功，添加表
12.   else
13.   {
14.    
15. cout << "create the database successful!" <<
16. endl;
18.     //creat the table
19.     int
20. i;
21.     for(i=1; i<nTableNum; i++)
22.    
23. {
24.       
25.     }

复制代码

    //插入一个表，返回值为SQLITE_OK为成功，否则输出出错信息

    //函数参数：第一个为操作数据库的指针，第二句为SQL命令字符串

    //第三个参数为callback函数，这里没有用，第四个参数为callback函数

    //中的第一个参数，第五个为出错信息

1. rc = sqlite3_exec(pDB, "CREATE TABLE
2. chn_to_eng(chinese QString, english QString)", 0, 0,
3. &errMsg);
5.     if(rc == SQLITE_OK)
6.       
7. cout << "create the chn_to_eng table successful!" <<
8. endl;
9.     else
10.        cout << errMsg
11. << endl;
13.     //同上，插入另一个表
14.     rc = sqlite3_exec(pDB, "CREATE TABLE
15. eng_to_chn(english QString, chinese QString)", 0, 0,
16. &errMsg);
18.     if(rc == SQLITE_OK)
19.         
20. cout << "create the eng_to_chn table successful!" <<
21. endl;
22.     else
23.        cout << errMsg
24. << endl;
25.    
26.   }
28.   //往表中添加数据
29.   char chn[]="...";
30.   char eng[]="...";
31.   char
32. value[500];
33.   //定义一条参数SQL命令，其中chn,eng为需要插入的数据   
34.   sprintf(value,
35. "INSERT INTO chn_to_eng(chinese, english) VALUES('%s', '%s')", chn,
36. eng);
37.   
38.   //use the SQLITE C/C++ API to create
39. and adjust a database.
40.   rc =
41. sqlite3_exec(pDB,
42.                        
43. value,
44.                       0, 0,
45. &errMsg);
47. //查询一条记录
48. char
49. value[500];
50. //定义一条查询语句，其中条件为当english为target时的中文记录
51. //print_result_cb为callback函数，在其中可以得到查询的结果，具体见下文
52. sprintf(value,
53. "SELECT chinese FROM eng_to_chn where english='%s' ",
54. target);
55.   
56. rc = sqlite3_exec(pDB,
57.                      
58. value,
59.                       print_result_cb, 0,
60. &errMsg);
62.   if(rc == SQLITE_OK)
63.       
64. {
65. //        #ifdef_debug
66.            cout
67. << "select the record successful!" << endl;
68. //        
69. #endif
70.       }
71.       else
72.       
73. {
74. //        #ifdef_debug
75.           cout
76. << errMsg << endl;  
77. //        
78. #endif                           
79.          
80. return false;
81.       }
83. .......
84. }
86. //callback回调函数print_result_cb的编写。其中第一个参数data为sqlite3_exec中的第四个参数，第二个参数是列的数目，第三个是查询得到的列值，第四个为列的名字。回调函数在每得到一行结果的时候就会执行一次，因为一次性返回全部结果会很占用较多的内存。下面这两个函数输出所有查询到的结果
87. int print_result_cb(void* data, int n_columns, char**
88. column_values,
89.                     char**
90. column_names)
91. {
92.     static int column_names_printed =
93. 0;
94.     int i;
95.     if (!column_names_printed)
96. {
97.         print_row(n_columns, column_names);
98.         
99. column_names_printed = 1;
100.     }
102.    
103. print_row(n_columns, column_values);
104.     return
105. 0;
106. }
110. void print_row(int
111. n_values, char** values)
112. {
113.     int i;
114.     for
115. (i = 0; i < n_values; ++i) {
116.         if (i > 0)
117. {
118.             printf("\t");
119.         
120. }
122.         printf("%s", values[i]);
123.         
125.     }
126.    
127. printf("\n");
128. }

复制代码

大致过程就是如此，具体可以参考SQLITE的API函数说明，见www.sqlite.org