sqlite3 API详解

爱被打了一巴掌 2022-02-04 10:23 505阅读 0赞

表的创建、修改、删除  
create table 表名(字段名 字段类型 \[约束\],...);  
alter table 表名 ｛rename to 新名字 | add column 字段 字段类型｝;  
drop table 表名 ;  
DML  
记录的增、删、改、查  
insert into 表名(字段名,...)values(字段值,...);  
insert into 表名 values(字段值,...);

delete from 表名 \[where 条件\];  
  
update 表名 set 字段=新值 \[where 条件\];  
  
select \* from 表名 \[where 条件\];  
  
\------------------------------------------  
sqlite3接口函数

sqlite3 数据库连接对象  
sqlite3\_stmt 编译后的SQL语句对象  
sqlite3\_open() 打开或创建一个数据库连接  
sqlite3\_prepare() 准备SQL语句  
sqlite3\_bind() 绑定参数  
sqlite3\_step() 执行准备好的SQL语句  
sqlite3\_column() 从sqlite3\_stmt中取字段值  
sqlite3\_finalize() 用来释放sqlite3\_stmt  
sqlite3\_close() 关闭数据库  
sqlite3\_exec() 执行SQL语句  
  
\------------------------------------  
sqlite3  
sqlite3\_open  
sqlite3\_exec  
sqlite3\_close  
sprintf()  
\-------------  
数据库的操作流程：  
1.连接数据库  
sqlite3 \*db;   
2.打开数据库  
int sqlite3\_open(  
const char \*filename, /\* 数据库名(字符串类型) \*/  
sqlite3 \*\*ppDb /\* sqlite3结构二级指针，数据库连接对象 \*/  
);  
返回值：成功返回 SQLITE\_OK，并且ppDb指向新的数据库连接  
其它值表示失败  
  
例：  
int res = sqlite3\_open("test.db",&db);  
if(res != SQLITE\_OK)  
\{  
     printf("open db err:%s\\n",sqlite3\_errmsg(db));  
     sqlite3\_close(db);  
     return -1;  
\}  
3.操作  
int sqlite3\_exec(  
sqlite3\*, 打开的数据库   
const char \*sql, 要执行的SQL语句(字符串)   
int (\*callback)(void\*,int,char\*\*,char\*\*), 回调函数  
void \*, 做为回调函数的第一个参数   
char \*\*errmsg 错误信息写在这里   
)  
SQL语句的执行分为两类：  
a.没有返回结果的情况，那么就不需要回调函数，给NULL即可  
如：create insert update delete...  
b.有结果集返回的情况，那么就需要通过回调函数去获取结果集  
每查到一条记录调用一次回调函数  
如：select  
  
int (\*callback)(void\* arg,传给回调函数的参数  
int column\_count,记录的字段(例)个数  
char\*\*column\_value,字段值(就是个一维数组)  
char\*\*column\_name)字段名(一维数组)  
例：  
char\* column\_name\[3\] = \{"abc","123","hello"\};  
  
  
4.关闭数据库  
int sqlite3\_close(sqlite3\*);

id name age addr   
  
1000 白起 20 CHINA   
1001 李牧 21 CHINA   
1002 王箭 21 CHINA   
1003 廉颇 25 CHINA

gcc sqlite3\_exec\_select.c   
\-I /usr/local/sqlite3/PC/include/ 指明头文件所在目录  
\-L /usr/local/sqlite3/PC/lib/ 指明库所在目录  
\-lsqlite3 所用的库的名字

\------------------------------------------------------------------------  
sqlite3 数据库连接对象  
sqlite3\_stmt 编译后的SQL语句对象  
sqlite3\_open() 打开或创建一个数据库连接  
sqlite3\_prepare() 准备SQL语句  
sqlite3\_bind() 绑定参数  
sqlite3\_step() 执行准备好的SQL语句  
sqlite3\_column() 从sqlite3\_stmt中取字段值  
sqlite3\_finalize() 用来释放sqlite3\_stmt  
sqlite3\_close()

1.打开数据库，建立连接  
2.准备SQL语句  
(如果SQL语句有可变的参数，那就要绑定值)  
int sqlite3\_prepare\_v2(  
sqlite3 \*db, /\* 数据库连接对象 \*/  
const char \*zSql, /\* 要执行的SQL语句 \*/  
int nByte, /\* SQL语句的长度 \*/ 可以为负数(-1)，自动计算长度  
sqlite3\_stmt \*\*ppStmt, /\* 准备好的SQL语句 \*/  
const char \*\*pzTail /\* 指向未执行的SQL语句\*/  
);  
char \*zSql = "create table....;intser into...";  
char \*pzTail = "intser into...";  
  
3.执行  
(如果是查询语句，那就需要获取结果集)  
int sqlite3\_step(sqlite3\_stmt\*);  
执行成功返回SQLITE\_DONE  
如果有数据返回时，执行成功返回SQLITE\_ROW  
  
4.释放sqlite3\_stmt对象  
int sqlite3\_finalize(sqlite3\_stmt \*pStmt);  
5.关闭

\-----------------  
int sqlite3\_bind\_blob(sqlite3\_stmt\*, int, const void\*, int n, void(\*)(void\*));  
int sqlite3\_bind\_double(sqlite3\_stmt\*, int, double);  
int sqlite3\_bind\_int(sqlite3\_stmt\*, int, int);  
int sqlite3\_bind\_null(sqlite3\_stmt\*, int);  
int sqlite3\_bind\_text(sqlite3\_stmt\*,int,const char\*,int,void(\*)(void\*));

第一、二个参数和返回值都是相同的：  
第一个参数：解析后的语句对象  
第二个参数：是要绑定的参数的索引号，从索引值1开始  
第三个参数：要给参数绑定的值  
第四个参数(如果有)：代表第三个参数的绑定值的长度  
第五个参数(如果有):是一个指向内存管理的回调函数的指针，一般给0  
回调函数：void callback(void\*);  
  
练习：  
用sqlite3\_bind\_blob,往数据库里存取图片

const void \*sqlite3\_column\_blob(sqlite3\_stmt\*, int iCol);  
int sqlite3\_column\_bytes(sqlite3\_stmt\*, int iCol);

double sqlite3\_column\_double(sqlite3\_stmt\*, int iCol);  
int sqlite3\_column\_int(sqlite3\_stmt\*, int iCol);  
const unsigned char \*sqlite3\_column\_text(sqlite3\_stmt\*, int iCol);  
int sqlite3\_column\_count(sqlite3\_stmt \*pStmt);

int sqlite3\_column\_type(sqlite3\_stmt\*, int iCol);  
返回五个存储类型对应的整数值：  
SQLITE\_INTEGER 1  
SQLITE\_FLOAT 2   
SQLITE\_TEXT 3  
SQLITE\_BLOB 4  
SQLITE\_NULL 5

/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*  
> File Name: sqlite3\_exec.c  
> Author: csgec  
> Mail: longer.zhou@gmail.com   
> Created Time: Thu 25 Aug 2016 10:07:00 AM CST  
\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*/

\#include<stdio.h>  
\#include<sqlite3.h>

int main()  
\{  
     //1.打开数据库，并建立数据库连接  
     sqlite3 \*db;  
     int res = sqlite3\_open("test.db",&db);  
     if(res != SQLITE\_OK)  
     \{  
          fprintf(stderr,"open err:%s\\n",sqlite3\_errmsg(db));  
          sqlite3\_close(db);  
          return -1;  
     \}  
printf("打开数据库test.db成功～～\\n");

//2.操作数据库，建表，增 删 改 查等操作  
char \*createSql = "create table if not exists stud(id integer primary key,name text not null,age integer check(age>6),addr text default 'CHINA')";  
char \*errmsg = NULL;  
res = sqlite3\_exec(db,createSql,NULL,NULL,&errmsg);  
if(res != SQLITE\_OK)  
\{  
     fprintf(stderr, "SQL error: %s\\n", errmsg);  
     sqlite3\_free(errmsg);  
\}  
printf("建表 stud 成功～\\n");

//3.关闭数据库  
     sqlite3\_close(db);  
     return 0;  
\}

/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*  
> File Name: sqlite3\_exec\_select.c  
> Author: csgec  
> Mail: longer.zhou@gmail.com   
> Created Time: Thu 25 Aug 2016 10:07:00 AM CST  
\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*/

\#include<stdio.h>  
\#include<sqlite3.h>

int callback(void\*arg,int column\_count,char \*\*column\_value,char\*\* column\_name)  
\{  
     printf("字段数：%d\\n",column\_count);  
     int i;  
     for(i = 0; i < column\_count; i++)  
     \{  
          printf("字段名:%s\\t",column\_name\[i\]);  
     \}  
     printf("\\n");  
  
     for(i = 0; i < column\_count; i++)  
     \{  
          printf("%s\\t",column\_value\[i\]);  
     \}  
     printf("\\n");

return 0;  
     \}

int main()  
\{  
     //1.打开数据库，并建立数据库连接  
     sqlite3 \*db;  
     int res = sqlite3\_open("test.db",&db);  
     if(res != SQLITE\_OK)  
     \{  
          fprintf(stderr,"open err:%s\\n",sqlite3\_errmsg(db));  
          sqlite3\_close(db);  
          return -1;  
     \}  
     printf("打开数据库test.db成功～～\\n");

//2.操作数据库，建表，增 删 改 查等操作  
     // char \*createSql = "create table if not exists stud(id integer primary key,name text not null,age integer check(age>6),addr text           default 'CHINA')";

char \*selectSql = "select \* from stud";  
     char \*errmsg = NULL;  
     res = sqlite3\_exec(db,selectSql,callback,NULL,&errmsg);  
     if(res != SQLITE\_OK)  
     \{  
          fprintf(stderr, "SQL error: %s\\n", errmsg);  
          sqlite3\_free(errmsg);  
     \}  
     printf("建表 stud 成功～\\n");

//3.关闭数据库  
     sqlite3\_close(db);  
     return 0;  
\}

/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*  
> File Name: sqlite3\_prepare.c  
> Author: csgec  
> Mail: longer.zhou@gmail.com   
> Created Time: Thu 25 Aug 2016 02:23:03 PM CST  
\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*/

\#include<stdio.h>  
\#include<sqlite3.h>  
\#include<string.h>  
int main()  
\{  
     sqlite3 \*db;  
     sqlite3\_stmt \*stmt;  
     //1  
     int res = sqlite3\_open("test.db",&db);  
     if(res != SQLITE\_OK)  
     \{  
          fprintf(stderr,"open error %s\\n",sqlite3\_errmsg(db));  
          sqlite3\_close(db);  
          return -1;  
     \}  
     printf("打开数据库test.db成功～\\n");

//2.  
     int id;  
     char name\[32\] = \{0\};  
     int age;  
     char \*insertSql = "insert into stud(id,name,age) values(?,?,?);";  
     printf("请输入ID：\\n");  
     scanf("%d",&id);  
     printf("请输入姓名：\\n");  
     scanf("%s",name);  
     printf("请输入年龄:\\n");  
     scanf("%d",&age);  
     res = sqlite3\_prepare\_v2(db,insertSql,strlen(insertSql),&stmt,0);  
     if(res != SQLITE\_OK)  
     \{  
          printf("sqlite3\_prepare\_v2 error\\n");  
          fprintf(stderr,"prepare error %s\\n",sqlite3\_errmsg(db));  
          return -1;  
     \}  
     sqlite3\_bind\_int(stmt,1,id);  
     sqlite3\_bind\_int(stmt,3,age);  
     sqlite3\_bind\_text(stmt,2,name,strlen(name),0);

//3  
     res = sqlite3\_step(stmt);  
     if(res != SQLITE\_DONE)  
     \{  
          printf("sqlite3\_step error\\n");  
          return -1;  
     \}  
     //4  
     sqlite3\_finalize(stmt);  
     sqlite3\_close(db);  
\}

/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*  
> File Name: sqlite3\_prepare\_select.c  
> Author: csgec  
> Mail: longer.zhou@gmail.com   
> Created Time: Thu 25 Aug 2016 02:23:03 PM CST  
\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*/

//2.  
     char \*selectSql = "select \* from stud;";  
     res = sqlite3\_prepare\_v2(db,selectSql,strlen(selectSql),&stmt,0);  
     if(res != SQLITE\_OK)  
     \{  
          printf("sqlite3\_prepare\_v2 error\\n");  
          fprintf(stderr,"prepare error %s\\n",sqlite3\_errmsg(db));  
          return -1;  
     \}

//3  
     res = sqlite3\_step(stmt);  
     /\*  
     if(res != SQLITE\_DONE)  
     \{  
          printf("sqlite3\_step error\\n");  
          return -1;  
     \}  
     \*/  
     int count = sqlite3\_column\_count(stmt);  
     printf("count = %d\\n",count);  
     int i;  
     //获取字段名和字段类型  
     for(i = 0; i < count; i++)  
     \{  
          printf("column name:%s\\n",sqlite3\_column\_name(stmt,i));  
          printf("column type:%i\\n",sqlite3\_column\_type(stmt,i));  
     \}  
  
     //获取字段值  
     int id;  
     const char \*name;  
     int age;  
     const char \*addr;  
     while(res == SQLITE\_ROW)  
     \{  
           id = sqlite3\_column\_int(stmt,0);  
          name = sqlite3\_column\_text(stmt,1);  
          age = sqlite3\_column\_int(stmt,2);  
          addr = sqlite3\_column\_text(stmt,3);  
          printf("id = %d,name = %s,age = %d,addr = %s\\n",  
          id,name,age,addr);

res = sqlite3\_step(stmt);  
     \}  
     //4  
     sqlite3\_finalize(stmt);  
     sqlite3\_close(db);  
\}

分类: [嵌入式学习][Link 1]

[Link 1]: https://www.cnblogs.com/liudehao/category/617880.html