C语言:SQLITE3的学习

时间:2024-01-21 23:46:03

Sqlite基础学习

一、sqlite的概念

  SQLite是一款轻型数据库,是遵守ACID的关系型数据库管理系统,由C语言开发设计。Sqlite的设计目标着眼于嵌入式领域,所以具有占用系统资源低和处理速度快等特点。

  SQLite是一个进程内的库,实现了自给自足的、无服务器的、零配置的、事务性的 SQL 数据库引擎。它是一个零配置的数据库,这意味着与其他数据库一样,您不需要在系统中配置。同时sqlite没有额外依赖并且完全开源,同时其源码拥有大量注释,可读性非常好。

二、Sqlite的用途

Sqlite支持跨平台,操作简单,能够使用很多语言直接创建数据库。如果你需要做一个很小型的应用,或者你想做嵌入式开发,没有合适的数据库系统,那么你可以考虑使用SQLite。例如android系统,IOS系统等都采用了SQLite做为数据库。

三、Sqlite语法简介

1、SQL简介

  SQL 是用于访问和处理数据库的标准的计算机语言。对于sqlite、mysql、sqlserver等数据库的操作语言都需要遵循SQL的规范,不过不同的数据库系统可能对SQL规范作了某些编改和扩充,所以不同数据库系统之间的SQL不能完全相互通用。

  SQL的一些基本操作:

(1)、面向数据库执行查询或取出数据

(2)、往数据库中插入新的记录

(3)、更新数据库中的数据

(4)、从数据库删除记录

(5)、建新数据库

(6)、在数据库中创建新表

  其相对应的操作语法大致如下:(以下只是列举一些语法,并不做说明)

(1)、(SELECT 列名称 FROM 表名称),(SELECT DISTINCT 列名称 FROM 表 名称),(SELECT 列名称 FROM 表名称 WHERE 列 运算符 值),

(SELECT 列名称1 列名称2 FROM 表名称 ORDER BY 列名称1)等等。

(2)、( INSERT INTO 表名称 VALUES (值1, 值2,....)),

(INSERT INTO table_name (列1, 列2,...) VALUES (值1, 值2,....))等。

(3)、(UPDATE 表名称 SET 列名称 = 新值 WHERE 列名称 = 某值)等。

(4)、(DELETE FROM 表名称 WHERE 列名称 = 值)等。

(5)、(CREATE DATABASE database_name)等。

(6)、CREATE TABLE 表名称

(

列名称1 数据类型,

列名称2 数据类型,

列名称3 数据类型,

....

)

2、Sqlite3常用函数说明

SQLITE_API int sqlite3_open(
  const char *filename,   /* Database filename (UTF-8) */
  sqlite3 **ppDb          /* OUT: SQLite db handle */
);
函数说明:该程序会通过指定的文件名参数打开一个数据库文件
数据库的连接返回到*ppDb,函数的返回值代表了操作状态,例如成功
就返回SQLITE_OK,否则返回错误代码和意外情况下不能分配内存来的得到
sqlite3就返回NULL

SQLITE_API int sqlite3_close(sqlite3*);
函数说明:前面如果用 sqlite3_open 开启了一个数据库,结尾时不要忘了用这个函数关闭数据库
同样返回值为操作状态

SQLITE_API int sqlite3_exec(
  sqlite3*,                                  /* An open database */
  const char *sql,                           /* SQL to be evaluated */
  int (*callback)(void*,int,char**,char**),  /* Callback function */
  void *,                                    /* 1st argument to callback */
  char **errmsg                              /* Error msg written here */
);
函数说明:该函数为具体执行SQL语句的函数
参数1:打开的数据库连接对象
参数2:传入的SQL语句,以‘/0’结尾
参数3:是回调函数,如果传入参数不为NULL,则得到一个结果行就会调用该回调函数
参数4:自定义的一个指针,目的是传入到回调函数参数以供使用。
参数5:错误信息,如果语句执行失败,就可以查阅该指针,这里的参数是输出特性
    (即主调函数将类型变量的地址传入,函数分配内存赋值给该变量)
    同时在执行完该函数后又不需要错误信息时,为了避免内存泄露,应该调用
    sqlite3_free()来释放这块内存
返回值:操作状态

SQLITE_API int sqlite3_get_table(
  sqlite3 *db,          /* An open database */
  const char *zSql,     /* SQL to be evaluated */
  char ***pazResult,    /* Results of the query */
  int *pnRow,           /* Number of result rows written here */
  int *pnColumn,        /* Number of result columns written here */
  char **pzErrmsg       /* Error msg written here */
);
函数说明:与sqlite3_exec功能相同,只是不使用回调函数而是直接一张表的内存和行与列
参数1:打开的数据库连接对象
参数2:该参数为输出特性,目的是函数内部返回一张表给主调函数使用,最终使用完需要
    释放是,不能调用 sqlite3_free() 而是要调用 sqlite3_free_table()来做释放
参数3:该参数为输出特性,修改pnRow的值为表的行数
参数4:该参数为输出特性,修改pnColumn的值为表的列数
参数5:错误信息,如果语句执行失败,就可以查阅该指针,这里的参数是输出特性
    同时在执行完该函数后又不需要错误信息时,为了避免内存泄露,应该调用
    sqlite3_free()来释放这块内存
返回值:操作状态

这些是比较常用的函数,至于更多的函数则不在多举例。

四、sqlite3使用例子

    1、操作数据库的一个简单例子(代码参考自别人)

#include<stdio.h>
#include<stdlib.h>
#include<string.h>
#include<sqlite3.h>
static int loadMyInfo(void* para, int column, char** columnValue,char** columnName)
{
int i = ;
for (i = ; i < column; i++)
{
printf("field name:%s ------> field values:%s\n", columnName[i],columnValue[i]);
}
printf("------------------------------------------------------\n");
return ;
}
int main(void)
{
sqlite3 *db = NULL;
int result;
char *errMsg = NULL;
//打开数据库
//传如sqlite3*类型变量的地址
result = sqlite3_open("/home/sns/workspace/database.db", &db);
if (result != SQLITE_OK)
{
printf("database open fail!\n");
return -;
}
//TODO 数据库操作代码
//sqlite的操作语句不区分大小写
//创建一个数据表,表名为MyTabale1,分两个字段:ID和name。
//其中ID是一个自动增加的整型,之后insert可以不去指定这个字段,它会自己从0开始增加
//name为一个含 32 个字符的可变长度 Unicode 字符数据.
result =sqlite3_exec(db,
"create table MyTable1(ID Integer primary key autoincrement,name nvarchar(32))",
NULL, NULL, &errMsg); //(字段名 字段类型 SQL约束)
if (result != SQLITE_OK)
{
printf("create a table fail!,fail code:%d,fail reason:%s\n", result,
errMsg);
}
if (errMsg != NULL)
{
sqlite3_free(errMsg);
errMsg = NULL;
}
//往表中插入三条记录
result = sqlite3_exec(db, "insert into MyTable1(name) values('zoulu')",NULL, NULL, &errMsg);
if (result != SQLITE_OK)
{
printf("insert a record fail!,fail code:%d,fail reason:%s\n", result,
errMsg);
}
if (errMsg != NULL)
{
sqlite3_free(errMsg);
errMsg = NULL;
}
result = sqlite3_exec(db, "insert into MyTable1(name) values('qidanche')",NULL, NULL, &errMsg);
if (result != SQLITE_OK)
{
printf("create a record fail!,fail code:%d,fail reason:%s\n", result,
errMsg);
}
if (errMsg != NULL)
{
sqlite3_free(errMsg);
errMsg = NULL;
}
result = sqlite3_exec(db, "insert into MyTable1(name) values('zuofeiji')",
NULL, NULL, &errMsg);
if (result != SQLITE_OK)
{
printf("create a record fail!,fail code:%d,fail reason:%s\n", result,
errMsg);
}
if (errMsg != NULL)
{
sqlite3_free(errMsg);
errMsg = NULL;
}
// 查询数据库
result = sqlite3_exec(db, "select * from MyTable1", loadMyInfo, NULL,&errMsg);
if (errMsg != NULL)
{
sqlite3_free(errMsg);
errMsg = NULL;
} //不使用回调函数查询数据库
char **dbResult = NULL;
int nRow, nColumn;
int index;
int i, j;
result = sqlite3_get_table(db, "select * from MyTable1", &dbResult, &nRow,&nColumn, &errMsg);
if (result == SQLITE_OK)
{
index = nColumn;
printf("find %d record\n", nRow); for (i = ; i < nRow; i++)
{
for (j = ; j < nColumn; j++)
{
printf("field name:%s ------> field values:%s\n", dbResult[j],
dbResult[index]);
index++;
}
printf(
"----------------------------------------------------------\n");
}
} sqlite3_free_table(dbResult);
//关闭数据库
sqlite3_close(db);
return EXIT_SUCCESS;
}

code1

    2、存取和读出二进制数据

#include<stdio.h>
#include<stdlib.h>
#include<string.h>
#include<sqlite3.h>
//sqlite 存取和读出二进制数据,需要使用sqlite3的sqlite3_stmt
int main(void)
{
sqlite3 *db1 = NULL;
char *errMsg=NULL;//保存错误信息
int result = ;
result = sqlite3_open("/home/sns/workspace/binarydatabase.db",&db1);
if(result!=SQLITE_OK)
{
printf("database open fail!\n");
return -;
}
//数据库操作 :
result = sqlite3_exec(db1,"create table BinTable2(ID integer,content blob)",NULL,NULL,&errMsg);
if(result != SQLITE_OK)
{
printf("create a table fail!,fail code:%d fail reason:%s",result,errMsg);
return -;
}
//写入二进制内容
sqlite3_stmt *stat;
void *pdata="hjktgagagf";
result = sqlite3_prepare( db1, "insert into BinTable2( ID, content) values( 10, ? )", -, &stat, );
if(result == SQLITE_OK && stat!=NULL)
{
sqlite3_bind_blob(stat,,pdata,sizeof(pdata),NULL);
printf("pdata length:%ld\n",sizeof(pdata));
result= sqlite3_step(stat);
if(result!=SQLITE_OK)
{
printf("write fail!\n");
}
}
if(stat)
{
sqlite3_finalize(stat);
}
//读出数据库记录
sqlite3_stmt *stat1=NULL;
result = sqlite3_prepare( db1, "select * from BinTable2", -, &stat1, );
if(result==SQLITE_OK)
{
result = sqlite3_step(stat1);
printf("result: %d\n",result);
if(result==SQLITE_ROW)
{
int id = sqlite3_column_int(stat1,);
const void * content = sqlite3_column_blob(stat1,);
int len = sqlite3_column_bytes(stat1,);
printf("\nid = %d,sizeof(content) = %d !\n",id,len);
}
}
if(stat1)
{
sqlite3_finalize(stat1);
}
//关闭数据库
sqlite3_close(db1);
return EXIT_SUCCESS;
}

code2

五:扩展说明

  关于sqlite3的C语言使用可以更多的关注该作者:https://home.cnblogs.com/u/elect-fans/

  本文第四项的操作二进制代码的说明请参考

    基于SQLITE数据库的C语言编程