SQLite库笔记：API函数编程

于 2024-08-03 10:59:37 发布
阅读量1.6k 收藏 28
点赞数 42
分类专栏： C 文章标签： 笔记 sqlite 数据库
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/starlight_0/article/details/140879923
版权

本文主要介绍SQLite库的一些核心API函数，和实现数据库增删查改功能的C语言示例程序代码。

目录

1. API函数原型

1.1 sqlite3_open

1.2 sqlite3_close

1.3 sqlite3_free

1.4 sqlite3_errmsg

1.5 sqlite3_exec

1.6 sqlite3_get_table

1.7 sqlite3_free_table

2. 返回码定义

3. 示例程序

3.1 数据库表设计

3.2 代码

3.3 编译运行

1. API函数原型

SQLite库有两百多个API，下面列出几个核心的API。

1.1 sqlite3_open

函数声明    

int sqlite3_open(const char *filename, sqlite3 **ppDb);

描述  

打开数据库文件

参数

filename[输入]  

数据库文件名 (UTF-8)

ppDb[输出]  

 SQLite db句柄

返回值

0-成功，其它-失败

1.2 sqlite3_close

函数声明    

int sqlite3_close(sqlite3* pDb);

描述  

关闭数据库db句柄

参数

pDb[输入]

数据库db句柄

返回值

0-成功，其它-失败

1.3 sqlite3_free

函数声明    

void sqlite3_free(void* ptr);

描述  

释放指针数据

参数

Ptr[输入]

指针数据

返回值

无

1.4 sqlite3_errmsg

函数声明    

const char *sqlite3_errmsg(sqlite3* pDb);

描述  

获取具体的错误信息

参数

pDb[输入]

数据库db句柄

返回值

错误信息字符串

1.5 sqlite3_exec

函数声明    

int sqlite3_exec(sqlite3*db, const char *sql,

                        int (*callback)(void*,int,char**,char**), void *arg, char **errmsg);

描述  

运行SQL语句

参数

db[输入]

一个打开的数据库db句柄

Sql[输入]

要执行的SQL语句

callback [输入]

回调函数

arg[输入]

回调函数的第一个参数

errmsg[输出]

错误信息

返回值

0-成功，其它-失败

1.6 sqlite3_get_table

函数声明    

int sqlite3_get_table(sqlite3 *db, const char *zSql, char ***pazResult,

                                int *pnRow, int *pnColumn, char **pzErrmsg);

描述  

运行SQL查询语句

参数

db[输入]

一个打开的数据库db句柄

zSql[输入]

要执行的SQL语句

pazResult[输出]

查询的结果

pnRow[输出]

查询结果的行数

pnColumn[输出]

查询结果的列数

pzErrmsg[输出]

错误信息

返回值

0-成功，其它-失败

1.7 sqlite3_free_table

函数声明    

void sqlite3_free_table(char **result);

描述  

释放SQL查询结果指针

参数

result [输入]

查询的结果

返回值

无

2. 返回码定义

sqlite3.h中常遇到的返回码

含义

SQLITE_OK (0)

成功

SQLITE_ERROR (1)

通用返回码

SQLITE_INTERNAL (2)

内部故障

SQLITE_PERM (3)

无法提供新创建的数据库的请求访问模式

SQLITE_ABORT (4)

操作中断

SQLITE_BUSY (5)

由于其它数据库连接的并发活动，无法读写

SQLITE_LOCKED (6)

连接冲突，写操作失败

3. 示例程序

3.1 数据库表设计

元素

类型

说明

id

int

货物ID

name

char(16)

货物名称

supplier

char(16)

供应商

ymdhms

datetime

年-月-日 时:分:秒

unit

int

单价

num

int

数量

sum

int

总价

3.2 代码

下面的代码实现了数据库的基本功能操作，包括：

  • 创建数据库文件test.db
  • 创建数据库表purchase
  • 向数据库表中插入数据
  • 修改数据库表的数据
  • 删除数据库表中特定ID的数据
  • 查询数据库表中数据条目数量
  • 查询数据库表中所有数据
/*  This is a demo using the SQLite library API functions.
 *  More details about SQLite: https://www.sqlite.org/
 */

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

#define DEBUG_PRINTF(format, ...)   printf("<%s, %d> "format" ", __func__, __LINE__, ## __VA_ARGS__)
#define ARRAY_SIZE(_arr)		    (sizeof((_arr)) / sizeof((_arr)[0]))
#define PURCHASE_DB_FILE			"test.db"

typedef struct _purchase_para{
	int id;
	char name[16];
	char supplier[16];
	char ymdhms[24];
	int unit;
	int num;
	int sum;
}purchase_para;

int iDBInit(sqlite3 **ppDb)
{
	char *err = NULL;
	char sql[256] = {0};
	int ret;

	/* database init */
	ret = sqlite3_open(PURCHASE_DB_FILE, ppDb);
	if (ret != SQLITE_OK) {
		DEBUG_PRINTF("sqlite3_open ret:%d, msg:%s\n", ret, sqlite3_errmsg(*ppDb));
		sqlite3_close(*ppDb);
		return -1;
	}

	snprintf(sql, sizeof(sql), 
		"create table if not exists purchase \
			(id int, \
			name char(16), \
			supplier char(16), \
   			ymdhms datetime,\
			unit int, \
			num int, \
			sum int, \
   			primary key(id, ymdhms));"
		);
	ret = sqlite3_exec(*ppDb , sql , NULL , NULL , &err);
	if (ret != SQLITE_OK) {
		DEBUG_PRINTF("sqlite3_exec ret:%d, %s\n", ret, err);
		sqlite3_free(err);
	}

	return 0;
}

void vDBFree(sqlite3 *pDb)
{
	if (pDb != NULL) {
		sqlite3_close(pDb);
		pDb = NULL;
	}
}

/* insert data */
int iDBInsert(sqlite3 *pDb, purchase_para *pdata)
{
	char sql[256] = {0};
	char *errmsg = NULL;
	int ret;

	if (pDb == NULL || pdata == NULL) {
		return -1;
	}

	snprintf(sql, sizeof(sql), 
			"insert into purchase(id, name, supplier, ymdhms, unit, num, sum) \
			values(%d, '%s', '%s', '%s', %d, %d, %d);", 
			pdata->id, pdata->name, pdata->supplier, pdata->ymdhms, 
			pdata->unit, pdata->num, pdata->sum);

	ret = sqlite3_exec(pDb , sql , NULL , NULL , &errmsg);
	if (ret != SQLITE_OK) {
		DEBUG_PRINTF("sqlite3_exec ret:%d, %s\n", ret, errmsg);
		sqlite3_free(errmsg);
	}
	return ret;
}

/* modify data if id matches */
int iDBUpdateByID(sqlite3 *pDb, purchase_para *pdata)
{
	char sql[256] = {0};
	char *errmsg = NULL;
	int ret;

	if (pDb == NULL || pdata == NULL) {
		return -1;
	}

	snprintf(sql, sizeof(sql), 
		"update purchase set name = '%s', supplier = '%s', ymdhms = '%s', \
        unit = %d, num = %d, sum = %d where id == %d;",
		pdata->name, pdata->supplier, pdata->ymdhms, 
		pdata->unit, pdata->num, pdata->sum, pdata->id);

	ret = sqlite3_exec(pDb , sql , NULL , NULL , &errmsg);
	if (ret != SQLITE_OK) {
		DEBUG_PRINTF("sqlite3_exec ret:%d, %s\n", ret, errmsg);
		sqlite3_free(errmsg);
	}
	return ret;
}

/* delete data if id matches */
int iDBDelByID(sqlite3 *pDb, int id)
{
	int ret = 0;
	char sql[64] = {0};
	char *errmsg = NULL;
	
	if (pDb == NULL) {
		return -1;
	}

	snprintf(sql, sizeof(sql), 
		"delete from purchase where id == %d;vacuum;", id);
	
	ret = sqlite3_exec(pDb , sql , NULL , NULL , &errmsg);
	if (ret != SQLITE_OK) {
		DEBUG_PRINTF("<%s> sqlite3_exec ret:%d, %s\n", __func__, ret, errmsg);
		sqlite3_free(errmsg);
	}
	return ret;
}

/* query the number of database data items */
int iDBQueryCnt(sqlite3 *pDb, int *cnt)
{
	int ret = 0;
	int row = 0;
	int column = 0;
	char **result;
	char sql[64] = {0};
	char *errmsg = NULL;
	
	snprintf(sql, sizeof(sql), "select count(*) from purchase;");

	ret = sqlite3_get_table(pDb , sql , &result , &row , &column , &errmsg);
	if (ret != SQLITE_OK) {
		DEBUG_PRINTF("<%s> sqlite3_exec ret:%d, %s\n", __func__, ret, errmsg);
		sqlite3_free(errmsg);
	}
	else {
		*cnt = atoi(result[1]);
		DEBUG_PRINTF("select successfully, row:%d, col:%d, cnt:%d\n", row, column, *cnt);		
	}
	sqlite3_free_table(result);
	return ret;
}

/* query all data in the database */
int iDBQueryAll(sqlite3 *pDb)
{
	int ret = 0;
	int row = 0;
	int column = 0;
	int i, j;
	char **result;
	char sql[64] = {0};
	char *errmsg = NULL;
	
	snprintf(sql, sizeof(sql), "select * from purchase;");

	ret = sqlite3_get_table(pDb , sql , &result , &row , &column , &errmsg);
	if (ret != SQLITE_OK) {
		DEBUG_PRINTF("<%s> sqlite3_exec ret:%d, %s\n", __func__, ret, errmsg);
		sqlite3_free(errmsg);
	}
	else {
		DEBUG_PRINTF("select successfully, row:%d, col:%d, data:\n", row, column);
		for(i = 0; i <= row; i++)
		{
			for(j = 0; j < column; j++)
			{
				printf("%s, ", result[i * column + j]);
			}
			printf("\n");
		}	
	}
	sqlite3_free_table(result);
	return ret;
}

测试示例

static void vTestInsert(sqlite3 *pDb)
{
	int i;
	int errcnt = 0;
	struct tm *timeinfo = NULL;
	time_t time_now;
	purchase_para data[] = {
		/*{1, "pencil", "sunny", "2024-07-10 12:06:35", 2, 100, 200},*/
		{1, "pencil", "sunny",  "", 2,  100, 200},
		{2, "pen",    "sky",    "", 10, 100, 1000},
		{3, "eraser", "lily",   "", 1,  80,  80},
		{4, "ruler",   "sunny", "", 2,  200, 400},
	};

	time(&time_now);
	timeinfo = localtime(&time_now);

	for(i = 0; i < ARRAY_SIZE(data); i++)
	{
		timeinfo->tm_mon = (timeinfo->tm_mon - i) % 12;
		strftime(data[i].ymdhms, ARRAY_SIZE(data[i].ymdhms), "%Y-%m-%d %H:%M:%S", timeinfo);
		if (iDBInsert(pDb, &data[i]) != 0) {
			errcnt++;
		}
	}
	DEBUG_PRINTF("insert %s\n", (errcnt == 0) ? "succ" : "fail");
}

static void vTestModify(sqlite3 *pDb)
{
	int ret;
	struct tm *timeinfo = NULL;
	time_t time_now;
	purchase_para data = {3, "eraser", "lily", "", 2, 80, 160};

	/* change the ymdhms to the current date and time */
	time(&time_now);
	timeinfo = localtime(&time_now);
	strftime(data.ymdhms, ARRAY_SIZE(data.ymdhms), "%Y-%m-%d %H:%M:%S", timeinfo);

	/* update data */
	ret = iDBUpdateByID(pDb, &data);
	DEBUG_PRINTF("modify %s\n", (ret == 0) ? "succ" : "fail");
}

int main(int argc, char* argv[])
{
	sqlite3 *ptrDb = NULL;
	int cnt = 0;
	int ret;

	if (iDBInit(&ptrDb) != 0) {
		return -1;
	}

	/* Query the number of database data items  */
	iDBQueryCnt(ptrDb, &cnt);
	/* Query all data in the database */
	iDBQueryAll(ptrDb);

	/* Insert some data */
	vTestInsert(ptrDb);
	/* modify data if id=3 */
	vTestModify(ptrDb);
	iDBQueryAll(ptrDb);

	/* delete data if id=4 */
	ret = iDBDelByID(ptrDb, 4);
	DEBUG_PRINTF("delete data %s\n", (ret == 0) ? "succ" : "fail");

	iDBQueryAll(ptrDb);

	vDBFree(ptrDb);
    return 0;
}

3.3 编译运行

将SQLite库编译生成的include和lib文件夹拷贝到工程目录下，编译加上-lsqlite3链接参数。编译示例如下：

运行结果：

忽见星光
关注
专栏目录
SQLite API
别呀的博客
04-09 588
一、SQLite常见API 主要还是记住常见的API，其他的···有需要用到时再查吧 1、打开数据库 函数原型：int sqlite3_open(const char *,sqlite3 **db) 功能：打开或创建数据库，并通过输出参数返回“连接” 参数： 1、数据库文件【IN】 2、sqlite3 数据指针【out】 返回值：错误代码，参见SQLite错误代码 使用说明： typedef struct sqlite3 sqlite3; 头文件 #include <sqlite3.h> 2、
java sqlite 创建_Android（java）学习笔记135：SQLite数据库（表）的创建 以及 SQLite数据库的升级...
weixin_30260191的博客
02-24 517
一、数据库的创建1.文件的创建//引用，如果文件不存在是不会创建的File file = new File("haha.txt")；//输出流写数据，文件才会被创建FileOutputStream fos = new FileOutputStream(file)；fos.write("".getBytes())；fos.close()；2.数据库的创建//执行下面这一点代码，数据库是不会被创建...
sqlite基础API
weixin_34107955的博客
03-26 88
/* 打开/创建数据库文件 * 如果数据库文件不存在就创建数据库文件。 * 数据库操作句柄保存在第二个参数中。 * 第一个参数：文件路径及其文件名 * 第二个参数：sqlite3操作句柄 * 返回值：SQLITE_OK表示成功 */ int sqlite3_open( 　　const char *filename, 　　sqlite3 **ppDb ); ...
sqlite API
Mr_weng
02-12 651
sqlite数据库的基本操作： 1.关键数据结构 sqlite 里最常用到的是 sqlite3 * 类型。从数据库打开开始，sqlite就要为这个类型准备好内存，直到数据库关闭，整个过程都需要用到这个类型。当数据库打开时开始，这个类型的变量就代表了你要操作的数据库。下面再详细介绍。 2.打开数据库 int sqlite3_open(filename, sqlit
SQLite3 C/C++ 开发接口简介（API函数）
嵌入我的梦想
12-07 1035
1.0 总览SQLite3是SQLite一个全新的版本,它虽然是在SQLite 2.8.13的代码基础之上开发的,但是使用了和之前的版本不兼容的数据库格式和API. SQLite3是为了满足以下的需求而开发的: 支持UTF-16编码. 用户自定义的文本排序方法. 可以对BLOBs字段建立索引. 因此为了支持这些特性我改变了数据库的格式,建立了
Sqlite c/c++ api 学习
热门推荐
10-07 1万+
    Sqlite是我最喜欢使用的文件数据库，它小巧、方便、速度快、支持大部分标准sql语句、开源、免费 .. .. .. 优点太多了。自从认识了她之后，我就将Access打入了冷宫，发誓以后再也不用Access了。我们可以到Sqlite的官方网站下载Sqlite的源代码，编译后的结果只有200多K，太小巧，太卡哇依了。如果嫌自己手动编译麻烦，也可以直接从官网下载二进制的可执行文件或者动态链接库
SQLite3 C语言API入门
weixin_30375247的博客
05-05 283
下载SQLite3 我们下载sqlite源码包，只需要其中的sqlite3.c、sqlite.h即可。 最简单的一个创建表操作 #include<stdio.h>#include"sqlite3.h"intmain(intargc,char*argv[]){constchar*sql_create_table="createtablet(idin...
SQlite数据库笔记总结详解
07-18
- 对于C/C++，可以使用SQLite的API函数，如sqlite3_open()打开数据库，sqlite3_exec()执行SQL命令，sqlite3_prepare_v2()预编译SQL语句等。 - 对于Java，JDBC驱动提供了java.sql.Connection、Statement和ResultSet...
SQLite开发笔记1
11-13
安装后，便可以在支持ODBC的任何编程语言中使用SQLite，例如C++中的OTL库，它可以简化对数据库的访问。 总的来说，SQLite是一个适用于单机和嵌入式环境的数据库解决方案，由于其源代码开放且注释良好，因此开发者...
Python库 | amocrm_api-0.8.1.tar.gz
02-28
`amocrm_api`库是开发者与AmoCRM系统进行数据交换的桥梁，允许开发者通过Python代码创建、读取、更新和删除AmoCRM中的数据，例如联系人、机会、笔记等。 **Python开发语言** Python是一种高级、通用的解释型编程...
sqlite API 中文手册 sql常见命令手册
11-28
sqlite API 中文学习手册 常见命令学习手册
sqlite(中文API)
03-23
sqlite(中文API) sqlite(中文API) sqlite(中文API) sqlite(中文API) sqlite(中文API)
rprogcoursenotes:我在 CourseraJHU R 编程课程（R. Peng，讲师）的讲座中做的笔记
06-12
- 数据接口：了解如何从 Web API 或数据库（如 MySQL、SQLite）中获取数据。 8. **R Markdown 和报告编写**： - R Markdown：使用 R Markdown 将 R 代码、文本和结果结合到一个可重复的文档中。 - knitr 和 ...
sqlite的API
javachs
08-24 271
API 从功能的角度来区分，SQLite的API可分为两类：核心API的扩充API。核心API由所有完成基本数据库操作的函数构成，包括：连接数据库、执行SQL和遍历结果集。它还包括一些功能函数，用来完成字符串格式化、操作控制、调试和错误处理等任务。扩充API提供不同的方法来扩展SQLite，它使你能够创建自定义的SQL扩展，并与SQLite本身的SQL相集成。 SQLite版本3的新特性 在...
sqlite API使用
xingyuan1hao的专栏
04-10 669
 转载：http://www.cnblogs.com/myqiao/archive/2011/07/10/2102465.html  入门教程https://www.sqlite.org/c3ref/column_blob.htmlhttp://blog.sina.com.cn/s/blog_a7c44c880101do3d.html 1、sqlite3_open在操作数据库之前需要先通过该接口打...
SQLite API函数
最新发布
weixin_52018852的博客
06-07 694
总之，SQLite 是一种轻量级的数据库引擎，并提供了丰富的 API 函数用于与其交互，用户可以通过这些函数实现 SQL 语句的执行、错误信息的获取，查询结果的处理等操作。SQLite 是一种嵌入式 SQL 数据库引擎，其库文件大小小、速度快，常被用于轻量级的数据库应用开发，也广泛支持不同的编程语言，如 C、C++、Python 等。sqlite3_open()函数用于打开一个SQLite数据库，返回一个sqlite3的指针，用于后续操作数据库。3.获取执行错误信息。
基于C API的SQLite3基本数据库操作
不断攀登
11-10 1422
作者：Leo Chin 出处：http://www.cnblogs.com/hnrainll/ SQLite是一款开源嵌入式文件型数据库，这个主要是和其他一些C/S架构的关系型数据库比较而来的，比如MySQL等。 说他是嵌入式，因为SQLite的所有功能全部包装在一个dll中，我们只需要使用其中的导出接口就可以操作SQLite数据库，这样使得数据存储功能能够很方便的集成进用户
SQLite3编程指南：API详解与实践
- **操作二进制**：SQLite支持BLOB类型来存储二进制数据，可以通过API函数读写BLOB字段。 - **事务处理**：SQLite支持事务，通过BEGIN、COMMIT和ROLLBACK命令来确保数据一致性。在API中，可以使用sqlite3_exec()的...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值