SQLite3 C语言API入门

分类：Sqlite作者：编程之家用户

下载SQLite3

我们下载sqlite源码包，只需要其中的sqlite3.c、sqlite.h即可。

最简单的一个创建表操作

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

intmain( intargc,char*argv[]){
const char*sql_create_table="createtablet(idintprimarykey,msgvarchar(128))";
char*errmsg=0;
intret=0;

sqlite3*db=0;
ret=sqlite3_open("./sqlite3-demo.db",&db);
if(ret!=SQLITE_OK){
fprintf(stderr,"Cannotopendb:%s\n",sqlite3_errmsg(db));
return1;
}
printf("Opendatabase\n");

ret=sqlite3_exec(db,sql_create_table,NULL,&errmsg);
}
sqlite3_free(errmsg);
sqlite3_close(db);

printf("Closedatabase\n");

return0;
}



在这个操作中我们执行了如下操作：

  • 打开数据库
  • 执行SQL语句
  • 关闭数据库

当然这中间会有一些状态的判断以及内存指针的释放等。

打开数据库的API如下：

intsqlite3_open(
char*filename,128,0)">/* Databasefilename(UTF-8) */
sqlite3**ppDb OUT:SQLitedbhandle */
);
这里会引入一个非常复杂的sqlite3的数据结构。这个根据需要以后酌情了解些。

打开数据库除了这种形式意外，还有sqlite3_open、sqlite3_open16、sqlite3_open_v2几种形式，基本上类似。

大部分sql操作都可以通过sqlite3_exec来完成，它的API形式如下：

intsqlite3_exec(
sqlite3*,0)">Anopendatabase */
char*sql,0)">SQLtobeevaluated int(*callback)( void*,255)">int,255)">char**,255)">char**),0)">Callbackfunction 1stargumenttocallback char**errmsg Errormsgwrittenhere */
);

各个参数的意义为：

  • sqlite3描述的是数据库句柄
  • sql 要执行的SQL语句
  • callback回调函数
  • void *回调函数的第一个参数
  • errmsg错误信息，如果没有SQL问题则值为NULL

回调函数式一个比较复杂的函数。它的原型是这样的:

intcallback( void* params,255)">intcolumn_size,255)">char**column_value,255)">char**column_name){

每一个参数意义如下：

  • params是sqlite3_exec传入的第四个参数
  • column_size是结果字段的个数
  • column_value是返回记录的一位字符数组指针
  • column_name是结果字段的名称

通常情况下callback在select操作中会使用到，尤其是处理每一行记录数。返回的结果每一行记录都会调用下“回调函数”。 如果回调函数返回了非0，那么sqlite3_exec将返回SQLITE_ABORT，并且之后的回调函数也不会执行，同时未执行的子查询也不会继续执行。

对于更新、删除、插入等不需要回调函数的操作，sqlite3_exec的第三、第四个参数可以传入0或者NULL。

通常情况下sqlite3_exec返回SQLITE_OK=0的结果，非0结果可以通过errmsg来获取对应的错误描述。

Windows下编译：

D:\home\dev\c>cl /nologo /TC sqlite3-demo.c sqlite3.c

GCC下编译:

$ gcc -o sqlite3-demo.bin sqlite3-demo.c sqlite3.c

删除表操作

为了防止垃圾数据，我们在加载数据库的时候删除表操作。

简单的删除操作可以直接使用sqlite3_exec即可。这里不需要回调函数以及回调函数的参数。 当然需要可以关注sqlite3_exec返回的结果是否为SQLITE_OK的值。

char*sql_drop_table="droptableifexistst";

sqlite3_exec(db,sql_drop_table,&errmsg);
sqlite3_exec(db,&errmsg);

插入数据

插入第一条数据

ret=sqlite3_exec(db,"insertintot(id,msg)values(1,'AdyLiu')",&errmsg);
printf("Insertarecord%s\n",ret==SQLITE_OK?"OK":"FAIL");

返回值ret为SQLITE_OK即操作成功。

插入多条数据，并删除数据

ret=sqlite3_exec(db,msg)values(2,'IMXYLZ')","deletefromtwhereid<3",&errmsg);
printf("Deleterecords:%s\n",ret==SQLITE_OK?"OK":"FAIL");
插入多条数据，简单的使用sqlite3_exec进行SQL执行即可。当然这里是完整的SQL字符串。

预编译操作

inti=0;
sqlite3_stmt*stmt;
charca[255];

// preparestatement
sqlite3_prepare_v2(db,msg)values(?,?)",-1,&stmt,0);
for(i=10;i<20;i++){
sprintf(ca,"HELLO#%i",i);
sqlite3_bind_int(stmt,1,i);
sqlite3_bind_text(stmt,2,ca,strlen(ca),NULL);
sqlite3_step(stmt);
sqlite3_reset(stmt);
}
sqlite3_finalize(stmt);
预编译操作比较麻烦的，完整的预编译操作的流程是：
  1. 通过sqlite3_prepare_v2()创建一个sqlite3_stmt对象
  2. 通过sqlite3_bind_*()绑定预编译字段的值
  3. 通过sqlite3_step()执行SQL语句
  4. 通过sqlite3_reset()重置预编译语句，重复操作2多次
  5. 通过sqlite3_finalize()销毁资源

sqlite3_prepare_v2()有个多种类似的形式，完整的API语法是：

intsqlite3_prepare(
sqlite3*db,0)">Databasehandle char*zSql,0)">SQLstatement,UTF-8encoded intnByte,0)">MaximumlengthofzSqlinbytes. */
sqlite3_stmt**ppStmt,0)">OUT:Statementhandle char**pzTail OUT:PointertounusedportionofzSql

各个参数的定义为：

  • db为sqlite3的句柄
  • zSql为要执行的SQL语句
  • nByte为要执行语句在zSql中的最大长度，如果是负数，那么就需要重新自动计算
  • ppStmt为预编译后的句柄
  • pzTail预编译后剩下的字符串（未预编译成功或者多余的）的指针，通常没什么用，传入0或者NULL即可。


绑定参数sqlite3_bind_*有多种形式，分别对应不同的数据类型:

intsqlite3_bind_blob(sqlite3_stmt*,255)">intn,255)">void(*)( void*));
intsqlite3_bind_double(sqlite3_stmt*,255)">double);
intsqlite3_bind_int(sqlite3_stmt*,255)">int);
intsqlite3_bind_int64(sqlite3_stmt*,sqlite3_int64);
intsqlite3_bind_null(sqlite3_stmt*,255)">intsqlite3_bind_text(sqlite3_stmt*,255)">char*,255)">intsqlite3_bind_text16(sqlite3_stmt*,255)">intsqlite3_bind_value(sqlite3_stmt*,255)">constsqlite3_value*);
intsqlite3_bind_zeroblob(sqlite3_stmt*,255)">intn);


预编译SQL语句中可以包含如下几种形式：

  • ?
  • ?NNN
  • :VVV
  • @VVV
  • $VVV

NNN代表数字，VVV代表字符串。

如果是?或者?NNN，那么可以直接sqlite3_bind_*()进行操作，如果是字符串，还需要通过sqlite3_bind_parameter_index()获取对应的index，然后再调用sqlite3_bind_*()操作。这通常用于构造不定条件的SQL语句（动态SQL语句）。

查询操作

回调函数的解释参考最上面的描述。 首先声明一个回调函数。

int print_record(void *,int,char **,char **);


查询代码

selectdata
ret=sqlite3_exec(db,"select*fromt",print_record,"querySQLerror:%s\n",errmsg);
}

现在定义回调函数，只是简单的输出字段值。

intprint_record( intn_column,255)">char**column_name){
inti;
for(i=0;i<n_column;i++){
printf("\t%s",column_value[i]);
}
printf("\n");
return0;
}

不使用回调的查询操作

定义使用的变量

 char **dbresult; int j,nrow,ncolumn,index;

查询操作

selecttable
ret=sqlite3_get_table(db,&dbresult,&nrow,&ncolumn,255)">if(ret==SQLITE_OK){
printf("query%irecords.\n",nrow);
index=ncolumn;
for(i=0;i<nrow;i++){
printf("[%2i]",i);
for(j=0;j<ncolumn;j++){
printf("%s",dbresult[index]);
index++;
}
printf("\n");
}
}
sqlite3_free_table(dbresult);

sqlite3_get_table的API语法：

intsqlite3_get_table(
sqlite3*db,255)">char***pazResult,0)">Resultsofthequery int*pnRow,0)">Numberofresultrowswrittenhere int*pnColumn,0)">Numberofresultcolumnswrittenhere char**pzErrmsg */
);
voidsqlite3_free_table( char**result);

其中：

  • db是sqlite3的句柄
  • zSql是要执行的sql语句
  • pazResult是执行查询操作的返回结果集
  • pnRow是记录的行数
  • pnColumn是记录的字段个数
  • pzErrmsg是错误信息

由于sqlite3_get_table是sqlite3_exec的包装，因此返回的结果和sqlite3_exec类似。

pazResult是一个(pnRow+1)*pnColumn结果集的字符串数组，其中前pnColumn个结果是字段的名称，后pnRow行记录是真实的字段值，如果某个字段为空，则对应值为NULL。

最后需要通过sqlite3_free_table()释放完整的结果集。

更新操作

 sqlite3_exec(db,"update t set msg='MESSAGE#10' where id=10",&errmsg);

当然了，我们也可以使用预编译方法进行更新操作。

受影响的记录数

我们可以使用sqlite3_change(sqlite3 *)的API来统计上一次操作受影响的记录数。

 ret = sqlite3_exec(db,"delete from t",&errmsg); 

if(ret == SQLITE_OK){

printf("delete records: %i\n",sqlite3_changes(db));

}

总结

这里我们接触了SQLITE3的13个API：

  • sqlite3_open()
  • sqlite3_exec()
  • sqlite3_close()
  • sqlite3_prepare_v2
  • sqlite3_bind_*()
  • sqlite3_bind_parameter_index()
  • sqlite3_step()
  • sqlite3_reset()
  • sqlite3_finalize()
  • sqlite3_get_table
  • sqlite3_change()
  • sqlite3_free()
  • sqlite3_free_table()

事实上截止到SQLITE3.7.14(2012/09/03) 一共提供了204个API函数（http://www.sqlite.org/c3ref/funclist.html）。

但最精简的API函数大概有6个：

  • sqlite3_open()
  • sqlite3_prepare()
  • sqlite3_step()
  • sqlite3_column()
  • sqlite3_finalize()
  • sqlite3_close()

核心API也就10个（在精简API基础上增加4个）：

  • sqlite3_exec()
  • sqlite3_get_table()
  • sqlite3_reset()
  • sqlite3_bind()

因此掌握起来还是比较容易的。

版权声明：本文内容由互联网用户自发贡献，该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 dio@foxmail.com 举报，一经查实，本站将立刻删除。

相关推荐

Java 嵌入数据处理引擎：SQLite 的挑战者 esProc SPL
SQLite架构简单，又有Json计算能力，有时会承担Json文件/RESTful的计算功能，但SQLite不能直接解析Json文件/RESTful，需要用Java代码硬写，或借助第三方类库，最后再拼成insert语句插入数据表，代码非常繁琐，这里就不展示了。参考前面的代码可知，入库的过程比较麻烦，不能只用SQL，还要借助Java或命令行。SPL是现代的数据计算语言，属于简化的面向对象的语言风格，有对象的概念，可以用点号访问属性并进行多步骤计算，但没有继承重载这些内容，不算彻底的面向对象语言。...
五、使用Python操作数据库
使用Python操作内置数据库SQLite以及MySQL数据库。
AndroidStudio-实现登录界面数据存储在SQLite
登陆界面
一文教会你导出微信聊天记录
破解微信数据库密码，用python导出微信聊天记录
UnitySqlite持久化数据
（Unity）SQLite 是一个软件库，实现了自给自足的、无服务器的、零配置的、事务性的 SQL 数据库引擎。SQLite 是在世界上最广泛部署的 SQL 数据库引擎。SQLite 源代码不受版权限制。本教程将告诉您如何使用 SQLite 编程，并让你迅速上手。.................................
Android用户登陆与注册功能的简单实现SQLite
安卓开发，利用SQLite实现登陆注册功能
SQLite——Java使用SQLite初体验
相比大多数数据库而言，具有等优势，广泛应用于、等领域。
使用SqlSugar连接多个数据库sqlserver，sqlite，mysql
有时候，一个项目只有一个数据库，比如只有SQLite，或者MySQL数据库，那么我们只需要使用一个固定的数据库即可。但是一个项目如果写好了，有多个用户使用，但是多个用户使用不同的数据库，这个时候，我们就需要把软件设计成可以连接多个数据库的模式，用什么数据库，就配置什么数据库即可。4.Users实体类，这个实体类要和数据库一样的，形成一一对应的关系。11.Sqlite数据库，需要在代码里面创建数据库，建立表，再建立数据。8.我们开启MySQL数据库，然后进行调试，看程序的结果。2.安装SqlSugar。
基于Android的背单词软件【源码+文档+答辩PPT】
基于Android的背单词软件，功能强大完整。
python ——操作sqlite 数据库
SQLite，是一款轻型的数据库，是遵守ACID的关系型数据库管理系统。说白了就是使用起来轻便简单，
Android -- 购物车
Android的简单购物车案例
SQLite3-轻量级数据库
SQLite，是一款轻型的数据库，是遵守ACID的关系型数据库管理系统，它包含在一个相对小的C库中。它是D.RichardHipp建立的公有领域项目。它的设计目标是嵌入式的，而且已经在很多嵌入式产品中使用了它，它占用资源非常的低，在嵌入式设备中，可能只需要几百K的内存就够了。它能够支持Windows/Linux/Unix等等主流的操作系统，同时能够跟很多程序语言相结合，比如 Tcl、C#、PHP、Java等，还有ODBC接口，同样比起Mysql、PostgreSQL这两款开源的世界著名数据库...
Qt设计精美的登录注册界面包含SQLite数据库应用
Qt设计较为美观好看的登录注册界面（包含SQLite数据库以及TCP通信的应用）
Java 嵌入数据处理引擎：SQLite 的挑战者
SQLite是用C语言开发的跨平台小型数据库，可嵌入其他开发语言，也可在单机执行。SPL是用Java开发的跨平台的数据计算语言，可嵌入Java，可在单机执行，可以数据计算服务的形式被远程调用。两者的代码都是解释执行的。...
Sqlite_入门命令
新建库.openDATA_BASE;新建表createtableLIST_NAME(DATA);语法:NAME关键字...<用逗号分割>删除表droptableNAME;查看表.schema查看表信息新建数据insertintoLIST_NAMEvalues();语法:CLASS,PARAMETER...,CLASS是类别,PARAMETER是参数<用逗号分割新建的
sqlite占位符的事例
importsqlite3classDemo01:def__init__(self):self.conn=sqlite3.connect("sql_demo_001.db")self.cursor1=self.conn.cursor()self.cursor1.execute("select*fromtable_001wherename=?andid=?",('ssss&#0
C# SQLite数据库
 在客户端配置文件<configuration>节点下，添加：<connectionStrings>      <add name="localdb" connectionString="Data Source=config/local.db;Version=3;UseUTF16Encoding=True;" providerName="System.Data.SQLite.SQLiteFactory"/&g
SQLite也可能出现死锁
提到锁就不得不说到死锁的问题，而SQLite也可能出现死锁。下面举个例子：连接1：BEGIN（UNLOCKED）连接1：SELECT...（SHARED）连接1：INSERT...（RESERVED）连接2：BEGIN（UNLOCKED）连接2：SELECT...（SHARED）连接1：COMMIT（PENDING，尝试获取EXCLUSIVE锁，但还有SHARED锁未释放，返回SQLITE_BUSY）连接2：INSERT...
PYTHON 对SQLITE3的简单使用
SQLite是一种嵌入式数据库，它的数据库就是一个文件。由于SQLite本身是C写的，而且体积很小，所以，经常被集成到各种应用程序中，甚至在iOS和Android的App中都可以集成。Python就内置了SQLite3，所以，在Python中使用SQLite，不需要安装任何东西，直接使用。在使用SQLite前，我们先要搞清楚几个概念：表
安卓入门——————简单记账本的开发用sqlite存储数据一
设计思想————首先要确定有几个页面、和每个页面的大致布局由于是入门，我也是学习了不是很长的时间，所以项目比较low。。。。第一个页面，也就是打开APP的首页面：今天这个博客，先实现添加功能！：首先对主界面进行布局：其中activity_main.xml的代码为<?xmlversion="1.0"encoding="
pythonJavaScriptjavaHTMLPHPreactjsC#AndroidCSSNode.jssqlrpython-3.xMysqLjQueryc++pandasFlutterangularIOSdjangolinuxswifttypescript路由器JSON路由器设置无线路由器h3c华三华三路由器设置华三路由器电脑软件教程arraysdocker软件图文教程Cvue.jslaravelspring-boot