sqlite3数据库高效API(六)

已于 2023-05-03 09:45:33 修改
阅读量1.4k 收藏 6
点赞数
分类专栏： # sqlite3 文章标签： 数据库 sqlite Powered by 金山文档
于 2023-02-24 00:10:49 首次发布
原文链接：https://www.sqlite.org/c3ref/funclist.html
版权
  1. sqlite3_open_v2
int sqlite3_open_v2(
const char *filename, /* Database filename (UTF-8) */
sqlite3 **ppDb, /* OUT: SQLite db handle */
int flags, /* Flags */
const char *zVfs /* Name of VFS module to use */
)

参数1:sqlite数据库文件名;

参数2:输出参数，数据库句柄;

参数3:标志,如下:

/* Ok for sqlite3_open_v2() 只读模式打开,若数据库不存在,则返回错误*/
#define SQLITE_OPEN_READONLY 0x00000001

/* Ok for sqlite3_open_v2() 若可能,将打开数据库进行读写,或仅在文件受操作系统写保护时才进行读取;这两种情况下数据库必须依据存在,否则返回错误;*/
#define SQLITE_OPEN_READWRITE 0x00000002

/* Ok for sqlite3_open_v2() 数据库不存则创建*/
#define SQLITE_OPEN_CREATE 0x00000004
#define SQLITE_OPEN_DELETEONCLOSE 0x00000008 /* VFS only */
#define SQLITE_OPEN_EXCLUSIVE 0x00000010 /* VFS only */
#define SQLITE_OPEN_AUTOPROXY 0x00000020 /* VFS only */

/* Ok for sqlite3_open_v2() 若设置了此标志,则文件名可解释成URL */
#define SQLITE_OPEN_URI 0x00000040

/* Ok for sqlite3_open_v2() 数据库将作为内存数据库打开;*/
#define SQLITE_OPEN_MEMORY 0x00000080
#define SQLITE_OPEN_MAIN_DB 0x00000100 /* VFS only */
#define SQLITE_OPEN_TEMP_DB 0x00000200 /* VFS only */
#define SQLITE_OPEN_TRANSIENT_DB 0x00000400 /* VFS only */
#define SQLITE_OPEN_MAIN_JOURNAL 0x00000800 /* VFS only */
#define SQLITE_OPEN_TEMP_JOURNAL 0x00001000 /* VFS only */
#define SQLITE_OPEN_SUBJOURNAL 0x00002000 /* VFS only */
#define SQLITE_OPEN_MASTER_JOURNAL 0x00004000 /* VFS only */

/* Ok for sqlite3_open_v2() 新的数据库连接将使用"多线程模式".意味着运行单独的线程同时使用SQLite,只要每个线程使用不同数据库连接;*/
#define SQLITE_OPEN_NOMUTEX 0x00008000

/* Ok for sqlite3_open_v2() 新的数据库将使用"序列化"线程模式;意味多个线程可以安全的尝试同时使用同一数据库连接;*/
#define SQLITE_OPEN_FULLMUTEX 0x00010000

/* Ok for sqlite3_open_v2() 数据库已启用共享缓存;*/
#define SQLITE_OPEN_SHAREDCACHE 0x00020000

/* Ok for sqlite3_open_v2() 数据库被打开共享缓存禁用;*/
#define SQLITE_OPEN_PRIVATECACHE 0x00040000
#define SQLITE_OPEN_WAL 0x00080000 /* VFS only */

参数4:sqlite3_vfs对象的名称,该对象定义了新数据库连接应该使用的操作系统接口; NULL表示使用默认的sqlite3_vfs对象;

  1. sqlite3_prepare_v2
int sqlite3_prepare_v2(
sqlite3 *db, /* Database handle. */
const char *zSql, /* UTF-8 encoded SQL statement. */
int nBytes, /* Length of zSql in bytes. */
sqlite3_stmt **ppStmt, /* OUT: A pointer to the prepared statement */
const char **pzTail /* OUT: End of parsed string */
)

首选sqlite3_prepare_v2( ); sqlite3_prepare( )接口是遗留的,应该避免; sqlite3_prepare_v3( )有一个二外的"prepFlags"选项,用于特殊用途;

参数1:sqlite3_open_v2等获取的数据句柄;

参数2:utf8编码格式的sql语句;

参数3:nBytes<0,则zSql被读取到第一个零终止符; nBytes=0,不会生成任何准备好的语句;nBytes>0,表示从zSql语句读取的字节数;

参数4:ppStmt指向一个编译好的准备好的语句,可以使用sqlite3_step()执行; 若参数2输入的文本不包含SQL（输入的是空字符串或注释）,则*ppStmt设置为NULL; 调用过程负责在编译完成后使用sqlite3_finalize()删除已编译的SQL语句;

返回值:指向成功返回SQLITE_OK；

  1. sqlite3_bind_xxx

将值绑定到准备好的语句

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_int64(sqlite3_stmt*, int, sqlite3_int64);
int sqlite3_bind_null(sqlite3_stmt*, int);
int sqlite3_bind_text(sqlite3_stmt*,int,const char*,int,void(*)(void*));

int sqlite3_bind_value(sqlite3_stmt*, int, const sqlite3_value*);
int sqlite3_bind_pointer(sqlite3_stmt*, int, void*, const char*,void(*)(void*));
int sqlite3_bind_zeroblob(sqlite3_stmt*, int, int n);

参数1: 由sqlite3_prepare_v2（）返回的sqlite3_stmt对象的指针;

参数2: 要设置的sql参数的索引;最左的sql参数的索引为1；当多次使用同一个命名的sql参数时,第二次和后续出现的索引与第一次出现的索引相同; 填1即可;

参数3: 要绑定到参数的值;若上述有该参数的是NULL指针,则忽略参数4；结果与sqlite3_bind_null相同;

参数4: 是参数3的字节数（字节而不是字符）

参数5:指示或控制参数3引用的对象的生存期; (1)可以传递一个析构函数,在sqlite处理完blob或字符串后处理它;即使对绑定API的调用失败,也会调用该函数来处理blob或字符串，但若参数3为NULL指针或参数4为负数,则不会调用析构函数; （2）可以传递常量SQLITE_STATIC,以知识应用程序任然负责处理对象；这种情况下,对象及其提供的指针必须保持有效,直到完成准备好的语句或将同一sql参数绑定到其他对象; （3）可以传递常量SQLITE_TRANSENT,以指示从sqlite3_bind_* 返回之前复制对象;

返回值: 成功返回SQLITE_OK;

  1. sqlite3_step
int sqlite3_step(sqlite3_stmt*);

在使用了sqlite3_prepare_v2()等准备好语句后,必须调用一次或多次该函数来评估sqlite语句;

SQLITE_DONE表示语句已经成功执行完毕;

  1. sqlite3_finalize
int sqlite3_finalize(sqlite3_stmt *pStmt);

调用sqlite3_finalize()函数以删除准备好的语句；

若最近换一次求值没有遇到错误,或者从未对语句求值 ,则sqlite3_finalize()返回SQLITE_OK;

6. 返回错误码

如果字符串或BLOB的大小超过sqlite3_limit（SQLITE_limit_LENGTH）或SQLITE_MAX_LENGTH所施加的限制，则可能返回SQLITE_TOOBIG。

如果参数索引超出范围，则返回SQLITE_RANGE。

如果malloc（）失败，则返回SQLITE_NOMEM。

7. 查询相关API
const void *sqlite3_column_blob(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); sqlite3_value *sqlite3_column_value(sqlite3_stmt*, int iCol); int sqlite3_column_bytes(sqlite3_stmt*, int iCol); int sqlite3_column_type(sqlite3_stmt*, int iCol);

上述例程返回有关查询的当前结果行的当个列的信息; 在每一种情况下,第一个参数都是一个sqlite3_stmt指针,由sqlite3_prepare_v2()获取; 第二个参数是返回其列的索引,结果最左侧的列的索引为0; 可以由sqlite3_column_count()确定结果中的列数；

若SQL语句当前未指向有效行,或者列索引超出范围,则结果未定义;只有在最近一次对sqlite3_step()的调用返回SQLITE_ROW并且既没有调用sqlite3_reset(),也没有调用sqlite3_finalize()时,才调用这些例程;

sqlite3_column_type()返回结果列的初始数据类型的数据类型代码;值是SQLITE_INTEGER、SQLITE_FLOAT、SQLITE_TEXT、SQLITE_BLOB或SQLITE_NULL之一；

若结果是BLOB或utf-8字符串,则sqlite3_column_bytes()接口来确定该BLOB或字符串的大小;返回的值是字符串的字节数而不是字符数;

8. 示例
#include <sqlite3.h>
#include <stdio.h>
#include <stdlib.h>
#include <time.h>
#include <unistd.h>
#include <string.h>


// 一条速度 信息
struct dr_speed_t
{
    time_t        start_time;    // 时间
    unsigned char            speed;        // 平均速度
    unsigned char            state;        // 状态信息
    unsigned char            reserved[2];
};

static sqlite3 *g_db = NULL;


//typedef int (*sqlite3_callback)(void*,int,char**, char**);

static int count_callback(void *args, int nCol, char **rowArr, char **colName)
{
    int *total_size = (int *)args;
    *total_size = atoi(*rowArr);
    
    return 0;
}

static int create_callback(void *args, int nCol, char **rowArr, char **colName)
{
    sqlite3 *db = (sqlite3 *)args;
    
    printf("nCol = %d %s \n",nCol, rowArr[0]);
    if(atoi(rowArr[0]) < 1){
        char sql[128], *err;
        int ret;

        snprintf(sql, sizeof(sql), "create table %s(tim INTEGER primary key, type INTEGER, bval blob)", "tab_product");
        ret = sqlite3_exec(db, sql, 0, 0, &err);
        if(ret != SQLITE_OK){
            if(err){
                sqlite3_free(err);
                return -1;
            }
        }
    }

    return 0;
}

int SqlSave(time_t tim, void *extData, int dataLen)
{
    char sql[128] = {0};
    char *err = NULL;
    int ret ;

    sqlite3_stmt *stmt = NULL;
    snprintf(sql, sizeof(sql),"replace into %s(tim,type,bval) values(%ld,%d,?)","tab_product",tim,0);
    ret = sqlite3_prepare_v2(g_db, sql, -1, &stmt, NULL);
    if(ret != SQLITE_OK){
        printf("sqlite3_prepare_v2 err\n");
        return -1;
    }

    ret = sqlite3_bind_blob(stmt, 1, extData, dataLen, NULL);
    if(ret != SQLITE_OK){
        goto ERR;
    }

    ret = sqlite3_step(stmt);
    if(ret != SQLITE_OK){
        goto ERR;
    }

    sqlite3_finalize(stmt);
    return 0;
ERR:
    sqlite3_finalize(stmt);
    return -1;
}

int SqlQueryCount(time_t start_time, time_t end_time)
{
    char sql[256], *err;
    int ret;
    int total_size = 0;

    snprintf(sql, sizeof(sql), "select count(*) from %s where tim >= %ld and tim < %ld", "tab_product", start_time, end_time);
    ret = sqlite3_exec(g_db, sql, count_callback, &total_size, &err);
    if(ret != SQLITE_OK){
        printf("sqlite3_exec err\n");
        return -1;
    }

    return total_size;
}

int SqlQuerySpeed(time_t start_time, time_t end_time)
{
    char sql[128] = {0};
    char *err = NULL;
    int ret ;

    printf("query count = %d\n",SqlQueryCount(start_time, end_time));

    sqlite3_stmt *stmt = NULL;
    snprintf(sql, sizeof(sql),"select * from %s where tim > %ld and tim < %ld order by tim desc","tab_product",start_time, end_time);
    ret = sqlite3_prepare_v2(g_db, sql, -1, &stmt, NULL);
    if(ret != SQLITE_OK){
        printf("sqlite3_prepare_v2 err\n");
        return -1;
    }

    while(1)
    {
        ret = sqlite3_step(stmt);
        if(ret != SQLITE_ROW){
            printf("query exit\n");
            break;
        }

        time_t tim = sqlite3_column_int(stmt, 0);
        int type = sqlite3_column_int(stmt, 1);
        struct dr_speed_t *speed = (struct dr_speed_t *)sqlite3_column_blob(stmt, 2);
        int blob_len = sqlite3_column_bytes(stmt, 2);
        if(blob_len != sizeof(struct dr_speed_t)){
            printf("--> query err\n");
        }

        printf("speed=%d time=%ld state=%d\n",speed->speed,speed->start_time,speed->state);
    }

    sqlite3_finalize(stmt);
    
    return 0;

}


int main(int argc, const char *argv[])
{
    
    char sql[128] = {0};
    char *err = NULL;
    int ret ;

    //读写,不存在则创建,多线程访问;
    ret = sqlite3_open_v2("./config.db", &g_db, SQLITE_OPEN_READWRITE|SQLITE_OPEN_CREATE|SQLITE_OPEN_FULLMUTEX, NULL);
    if(ret != SQLITE_OK){
        printf("sqlite_open_v2 err\n");
        return -1;
    }

    //检查数据表是否存在,不存在回调里创建
    snprintf(sql,sizeof(sql),"select count(*) from sqlite_master where type='table' and name='%s'","tab_product");
    ret = sqlite3_exec(g_db, sql, create_callback, g_db, &err);
    if(ret != SQLITE_OK){
        sqlite3_free(err);
        sqlite3_close_v2(g_db);
    }

    //保存100次数据,正常情况下单次保存;
    struct dr_speed_t speed;
    time_t t = time(NULL);
    for(int i = 0; i < 100; ++i){
        memset(&speed, 0, sizeof(struct dr_speed_t));
        speed.speed = i;
        speed.start_time = t/1000 + i;
        speed.state = ((i % 2) == 0) ? 0 : 1;
        SqlSave(speed.start_time,&speed,sizeof(struct dr_speed_t));
    }

    sleep(1);

    //批量查询
    SqlQuerySpeed(0, time(NULL));

    sqlite3_close_v2(g_db);

    return 0;
}
天未及海宽
关注
专栏目录
SQLite API
别呀的博客
04-09 596
一、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、
Nodejs操作Sqlite3数据库封装
07-24
本篇文章将深入探讨如何使用`node-sqlite3`库来操作SQLite3数据库，并对其进行封装，以便于在实际项目中更高效地使用。 首先，`node-sqlite3`是Node.js的一个数据库驱动，它提供了与SQLite3数据库交互的接口。安装...
SQLite3 C语言API入门
weixin_30375247的博客
05-05 291
下载SQLite3 我们下载sqlite源码包，只需要其中的sqlite3.c、sqlite.h即可。 最简单的一个创建表操作 #include<stdio.h>#include"sqlite3.h"intmain(intargc,char*argv[]){constchar*sql_create_table="createtablet(idin...
Sqlite3数据库表内数据批量读取操作---sqlite3_stmt机制
最新发布
weixin_49337111的博客
08-23 867
sqlite3_stmt是 SQLite 数据库在 C 语言接口中使用的一个关键数据结构，它代表了一个“准备语句对象”（prepared statement object），也是一个预编译的 SQL 语句，预编译 SQL 语句可以提高执行效率并防止 SQL 注入攻击。这个对象是对 SQL 语句的一种封装，该 SQL 语句已经被编译成字节码形式，可以直接由 SQLite 的虚拟机执行。如果只是读取一条数据时，使用sqlite3_exec和sqlite3_stmt效率是一样的，但是当涉及到大批量的操作时，此前
Sqlite c/c++ api 学习
热门推荐
10-07 1万+
    Sqlite是我最喜欢使用的文件数据库，它小巧、方便、速度快、支持大部分标准sql语句、开源、免费 .. .. .. 优点太多了。自从认识了她之后，我就将Access打入了冷宫，发誓以后再也不用Access了。我们可以到Sqlite的官方网站下载Sqlite的源代码，编译后的结果只有200多K，太小巧，太卡哇依了。如果嫌自己手动编译麻烦，也可以直接从官网下载二进制的可执行文件或者动态链接库
sqlite API
Mr_weng
02-12 656
sqlite数据库的基本操作： 1.关键数据结构 sqlite 里最常用到的是 sqlite3 * 类型。从数据库打开开始，sqlite就要为这个类型准备好内存，直到数据库关闭，整个过程都需要用到这个类型。当数据库打开时开始，这个类型的变量就代表了你要操作的数据库。下面再详细介绍。 2.打开数据库 int sqlite3_open(filename, sqlit
SQLite3 C/C++ 开发接口简介（API函数）
嵌入我的梦想
12-07 1049
1.0 总览SQLite3是SQLite一个全新的版本,它虽然是在SQLite 2.8.13的代码基础之上开发的,但是使用了和之前的版本不兼容的数据库格式和API. SQLite3是为了满足以下的需求而开发的: 支持UTF-16编码. 用户自定义的文本排序方法. 可以对BLOBs字段建立索引. 因此为了支持这些特性我改变了数据库的格式,建立了
sqlite的API
javachs
08-24 277
API 从功能的角度来区分，SQLite的API可分为两类：核心API的扩充API。核心API由所有完成基本数据库操作的函数构成，包括：连接数据库、执行SQL和遍历结果集。它还包括一些功能函数，用来完成字符串格式化、操作控制、调试和错误处理等任务。扩充API提供不同的方法来扩展SQLite，它使你能够创建自定义的SQL扩展，并与SQLite本身的SQL相集成。 SQLite版本3的新特性 在...
Sqlite3数据库支持库
07-24
同时，它还有丰富的API和绑定，如Python的sqlite3模块，Java的SQLiteJDBC，JavaScript的sqlite3库等，方便在各种编程环境中使用。 9. 安全性：SQLite3提供加密选项，可以通过第三方扩展库如SQLite Encryption ...
sqlite3数据库权威指南
02-06
SQLite3是一种轻量级、开源的嵌入式关系数据库管理系统，广泛应用于移动设备、桌面系统以及服务器环境。...通过理解和掌握其C语言API，你可以轻松地在你的项目中集成和操作SQLite3数据库，实现高效的数据管理。
VB6.0 操作SQLite 数据库的完整示例代码
08-02
在VB6.0中操作SQLite数据库，是一种将轻量级、高性能的SQLite数据库与传统...通过提供的SQLite VB6.0完整示例，开发者可以深入学习和理解如何在VB6环境中高效、安全地操作SQLite数据库，为项目带来强大的数据管理能力。
sqlite(中文API)
03-23
sqlite(中文API) sqlite(中文API) sqlite(中文API) sqlite(中文API) sqlite(中文API)
sqlite API 中文手册 sql常见命令手册
11-28
sqlite API 中文学习手册 常见命令学习手册
linux下c语言操作sqlite3数据库.zip
06-16
在Linux环境下，C语言操作SQLite3数据库是一种常见的数据存储与管理技术。...通过熟练掌握SQLite3的API和C语言编程，你可以构建高效、可靠的数据库应用。记得在实践中不断学习和改进，以适应不断变化的技术需求。
SQLite API函数
weixin_52018852的博客
06-07 706
总之，SQLite 是一种轻量级的数据库引擎，并提供了丰富的 API 函数用于与其交互，用户可以通过这些函数实现 SQL 语句的执行、错误信息的获取，查询结果的处理等操作。SQLite 是一种嵌入式 SQL 数据库引擎，其库文件大小小、速度快，常被用于轻量级的数据库应用开发，也广泛支持不同的编程语言，如 C、C++、Python 等。sqlite3_open()函数用于打开一个SQLite数据库，返回一个sqlite3的指针，用于后续操作数据库。3.获取执行错误信息。
sqlite API使用
xingyuan1hao的专栏
04-10 676
 转载：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操作
m0_73492050的博客
12-07 294
(1)下载安装数据库 (2)安装函数库 否则编译会出现以下问题： zgy@zgy-virtual-machine:~/sqlite$ gcc student.c -o student -lsqlite3 student.c:2:10: fatal error: sqlite3.h: 没有那个文件或目录 2 | #include | ^~~~~~~~~~~ compilation terminated. zgy@zgy-virtual-machine:~/sqlite
sqlite3 API for C
weixin_45066336的博客
08-10 958
C语言调用接口操作sqlite数据库，本文只介绍了部分基本操作的接口，满足日常使用，包括接口的参数说明与代码使用示例
Sqlite3 Api
weixin_43152585的博客
04-09 190
Sqlite3 Api 数据库的打开 int sqlite3_open( const char *filename, /* Database filename (UTF-8) */ sqlite3 **ppDb /* OUT: SQLite db handle */ ); //返回值为 SQLITE_OK 表示操作正常 //例子 其中sqlite3 * ...
SQLite 数据库介绍
06-10
SQLite 是一个轻型的、开源的、基于文件的关系型数据库管理系统（RDBMS），广泛应用于移动设备、桌面应用程序、嵌入式系统和 Web 应用程序等领域。SQLite 的设计目标是实现一个小型、快速、自给自足、高可靠性的 SQL 数据库引擎，具有高效的读写性能和小巧的体积，非常适合在嵌入式设备和移动设备上使用。 SQLite 提供了标准的 SQL 查询语言和事务处理机制，并支持多种数据类型和索引类型。与其他数据库管理系统不同的是，SQLite 不需要独立的服务器进程或操作系统进程，而是将整个数据库作为一个文件存储在计算机中，可以直接通过文件系统进行访问和操作。这种设计使 SQLite 具有非常小的内存占用和快速的启动速度，同时也使得 SQLite 数据库文件非常容易进行备份和迁移。 在 Android 平台上，SQLite 是默认的关系型数据库管理系统，广泛用于 Android 应用程序的数据存储和管理。Android 提供了 SQLiteOpenHelper 类和 ContentProvider 类等 API 来帮助开发者使用 SQLite 数据库，使得 Android 应用程序的数据存储变得非常方便和高效。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值