非常教程

Sqlite参考手册

C界面 | C Interface

Convenience Routines For Running Queries

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 */
);
void sqlite3_free_table(char **result);

这是为了向后兼容而保留的传统界面。不推荐使用此接口。

定义:结果表是由 sqlite3_get_table() 接口创建的内存数据结构。结果表记录来自一个或多个查询的完整查询结果。

该表概念上具有许多行和列。但是这些数字不是结果表本身的一部分。这些数字是分别获得的。令 N 为行数,M 为列数。

结果表是指向零终止的 UTF-8 字符串的指针数组。数组中有(N + 1)* M 个元素。前 M 个指针指向包含列名称的以零结尾的字符串。剩下的条目都指向查询结果。NULL 值导致 NULL 指针。所有其他值都是以 sqlite3_column_text() 返回的 UTF-8 零终止字符串表示形式表示的。

结果表可能包含一个或多个内存分配。将结果表直接传递给 sqlite3_free() 是不安全的。结果表应该使用 sqlite3_free_table() 来解除分配。

作为结果表格式的一个例子,假设查询结果如下:

Name        | Age
-----------------------
Alice       | 43
Bob         | 28
Cindy       | 21

有两列(M == 2)和三行(N == 3)。因此结果表有8个条目。假设结果表存储在数组名称 azResult 中。然后 azResult 持有这个内容:

azResult[0] = "Name";
azResult[1] = "Age";
azResult[2] = "Alice";
azResult[3] = "43";
azResult[4] = "Bob";
azResult[5] = "28";
azResult[6] = "Cindy";
azResult[7] = "21";

sqlite3_get_table() 函数计算第二个参数的零终止 UTF-8 字符串中的一个或多个以分号分隔的 SQL 语句,并将结果表返回给第三个参数中指定的指针。

在应用程序完成 sqlite3_get_table() 的结果后,它必须将结果表指针传递给 sqlite3_free_table() 以释放已配对的内存。由于 sqlite3_malloc() 在 sqlite3_get_table() 中发生,调用函数不能直接调用 sqlite3_free() 。只有 sqlite3_free_table() 能够正确和安全地释放内存。

sqlite3_get_table() 接口作为 sqlite3_exec() 的包装实现。sqlite3_get_table() 例程不能访问 SQLite 的任何内部数据结构。它仅使用此处定义的公共接口。因此,在内部 sqlite3_exec() 调用之外的包装器层发生的错误不会在随后调用 sqlite3_errcode() 或 sqlite3_errmsg() 时反映出来。

C界面 | C Interface相关

1.64-Bit Integer Types
2.A Handle To An Open BLOB
3.An Introduction To The SQLite C/C++ Interface
4.Application Defined Page Cache
5.Attempt To Free Heap Memory
6.Authorizer Action Codes
7.Authorizer Return Codes
8.Automatically Load Statically Linked Extensions
9.Binding Values To Prepared Statements
10.C/C++ Interface For SQLite Version 3
11.C/C++ Interface For SQLite Version 3 (old)
12.Cancel Automatic Extension Loading
13.Checkpoint a database
14.Checkpoint Mode Values
15.Close A BLOB Handle
16.Closing A Database Connection
17.Collation Needed Callbacks
18.Column Names In A Result Set
19.Commit And Rollback Notification Callbacks
20.Compare the ages of two snapshot handles
21.Compile-Time Authorization Callbacks
22.Compile-Time Library Version Numbers
23.Compiling An SQL Statement
24.Configuration Options
25.Configure an auto-checkpoint
26.Configure database connections
27.Configuring The SQLite Library
28.Conflict resolution modes
29.Constants Defining Special Destructor Behavior
30.Copy And Free SQL Values
31.Count The Number Of Rows Modified
32.Create Or Redefine SQL Functions
33.Custom Page Cache Object
34.Data Change Notification Callbacks
35.Database Connection Configuration Options
36.Database Connection For Functions
37.Database Connection Handle
38.Database Connection Status
39.Database Snapshot
40.Declare The Schema Of A Virtual Table
41.Declared Datatype Of A Query Result
42.Define New Collating Sequences
43.Deprecated Functions
44.Deprecated Soft Heap Limit Interface
45.Destroy A Prepared Statement Object
46.Destroy a snapshot
47.Determine if a database is read-only
48.Determine If A Prepared Statement Has Been Reset
49.Determine If An SQL Statement Is Complete
50.Determine If An SQL Statement Writes The Database
51.Determine The Virtual Table Conflict Policy
52.Device Characteristics
53.Dynamically Typed Value Object
54.Enable Or Disable Extended Result Codes
55.Enable Or Disable Extension Loading
56.Enable Or Disable Shared Pager Cache
57.Error Codes And Messages
58.Error Logging Interface
59.Evaluate An SQL Statement
60.Experimental Interfaces
61.Extended Result Codes
62.Extract Metadata About A Column Of A Table
63.File Locking Levels
64.Find The Database Handle Of A Prepared Statement
65.Find the next prepared statement
66.Finding The Subtype Of SQL Values
67.Flags For File Open Operations
68.Flags for the xAccess VFS method
69.Flags for the xShmLock VFS method
70.Flush caches to disk mid-transaction
71.Formatted String Printing Functions
72.Free Memory Used By A Database Connection
73.Function Auxiliary Data
74.Function Flags
75.Fundamental Datatypes
76.Impose A Limit On Heap Size
77.Index Of A Parameter With A Given Name
78.Initialize The SQLite Library
79.Interrupt A Long-Running Query
80.Introduction
81.Last Insert Rowid
82.List Of SQLite Constants
83.List Of SQLite Functions
84.List Of SQLite Objects
85.Load An Extension
86.Loadable Extension Thunk
87.Low-Level Control Of Database Files
88.Low-level system error code
89.Maximum xShmLock index
90.Memory Allocation Routines
91.Memory Allocation Subsystem
92.Memory Allocator Statistics
93.Move a BLOB Handle to a New Row
94.Mutex Handle
95.Mutex Methods Object
96.Mutex Types
97.Mutex Verification Routines
98.Mutexes
99.Name Of A Host Parameter
100.Name Of The Folder Holding Database Files
Sqlite

SQLite,是一款轻型的数据库,是遵守ACID的关系型数据库管理系统,它包含在一个相对小的C库中。它是D.RichardHipp建立的公有领域项目。它的设计目标是嵌入式的,而且目前已经在很多嵌入式产品中使用了它,它占用资源非常的低,在嵌入式设备中,可能只需要几百K的内存就够了。它能够支持Windows/Linux/Unix等等主流的操作系统,同时能够跟很多程序语言相结合,比如 Tcl、C#、PHP、Java等,还有ODBC接口,同样比起Mysql、PostgreSQL这两款开源的世界著名数据库管理系统来

主页 https://sqlite.org/
源码 https://www.sqlite.org/src/
发布版本 3.21.0

Sqlite目录

1.C界面 | C Interface
2.C Interface: Session Module
3.CLI
4.数据库文件表 | Database File Format
5.数据类 | Datatypes
6.动态内存分配 | Dynamic Memory Allocation
7.外键约束 | Foreign Key Constraints
8.全文索引 | Full-Text Search
9.损坏方式 | How To Corrupt
10.JSON
11.语言 | Language
12.局限性 | Limits
13.锁定和并发 | Locking and Concurrency
14.其他 | Miscellaneous
15.PRAGMA Statements
16.查询计划程序 | Query Planner
17.R*Tree Module
18.RBU Extension
19.语法图 | Syntax Diagrams
20.Tcl Interface
21.虚拟表机制 | Virtual Table Mechanism
22.预写日志 | Write-Ahead Logging
23.SQL 教程
24.SQL 简介
25.SQL 语法
26.SQL DELETE 语句
27.SQL UPDATE 语句
28.SQL NOT NULL 约束
29.SQL 约束
30.SQL CREATE TABLE 语句
31.SQL CREATE DATABASE 语句
32.SQL INSERT INTO SELECT 语句
33.SQL SELECT INTO 语句
34.SQL CREATE VIEW、REPLACE VIEW、 DROP VIEW 语句
35.SQL AUTO INCREMENT 字段
36.SQL ALTER TABLE 语句
37.SQL 撤销索引、表以及数据库
38.SQL CREATE INDEX 语句
39.SQL DEFAULT 约束
40.SQL CHECK 约束
41.SQL FOREIGN KEY 约束
42.SQL PRIMARY KEY 约束
43.SQL UNIQUE 约束
44.SQL 通用数据类型
45.SQL ISNULL()、NVL()、IFNULL() 和 COALESCE() 函数
46.SQL NULL 值 – IS NULL 和 IS NOT NULL
47.SQL Server 和 MySQL 中的 Date 函数
48.SQL MS Access、MySQL 和 SQL Server 数据类型
49.SQL 函数
50.SQL 总结
51.SQL 主机
52.SQL 快速参考
53.SQL ROUND() 函数
54.SQL Server GETDATE() 函数
55.MySQL DATE_FORMAT() 函数
56.MySQL DATEDIFF() 函数
57.MySQL DATE_SUB() 函数
58.MySQL DATE_ADD() 函数
59.MySQL EXTRACT() 函数
60.MySQL DATE() 函数
61.MySQL CURTIME() 函数
62.MySQL CURDATE() 函数
63.MySQL NOW() 函数
64.SQL Server CONVERT() 函数
65.SQL Server DATEDIFF() 函数
66.SQL Server DATEADD() 函数
67.SQL Server DATEPART() 函数
68.SQLite 命令
69.SQLite 安装
70.SQLite 简介
71.SQLite 运算符
72.SQLite Select 语句
73.SQLite 删除表
74.SQLite 创建表
75.SQLite Insert 语句
76.SQLite 分离数据库
77.SQLite 附加数据库
78.SQLite 创建数据库
79.SQLite 数据类型
80.SQLite 语法
81.SQLite Order By
82.SQLite Limit 子句
83.SQLite Glob 子句
84.SQLite Like 子句
85.SQLite Delete 语句
86.SQLite Update 语句
87.SQLite AND/OR 运算符
88.SQLite Where 子句
89.SQLite 表达式
90.SQLite Distinct 关键字
91.SQLite Having 子句
92.SQLite Group By
93.SQLite Join
94.SQLite 约束
95.SQLite PRAGMA
96.SQLite 事务
97.SQLite 视图
98.SQLite Truncate Table
99.SQLite Alter 命令
100.SQLite Indexed By