非常教程

Sqlite参考手册

C界面 | C Interface

Setting The Result Of An SQL Function

void sqlite3_result_blob(sqlite3_context*, const void*, int, void(*)(void*));
void sqlite3_result_blob64(sqlite3_context*,const void*,
                           sqlite3_uint64,void(*)(void*));
void sqlite3_result_double(sqlite3_context*, double);
void sqlite3_result_error(sqlite3_context*, const char*, int);
void sqlite3_result_error16(sqlite3_context*, const void*, int);
void sqlite3_result_error_toobig(sqlite3_context*);
void sqlite3_result_error_nomem(sqlite3_context*);
void sqlite3_result_error_code(sqlite3_context*, int);
void sqlite3_result_int(sqlite3_context*, int);
void sqlite3_result_int64(sqlite3_context*, sqlite3_int64);
void sqlite3_result_null(sqlite3_context*);
void sqlite3_result_text(sqlite3_context*, const char*, int, void(*)(void*));
void sqlite3_result_text64(sqlite3_context*, const char*,sqlite3_uint64,
                           void(*)(void*), unsigned char encoding);
void sqlite3_result_text16(sqlite3_context*, const void*, int, void(*)(void*));
void sqlite3_result_text16le(sqlite3_context*, const void*, int,void(*)(void*));
void sqlite3_result_text16be(sqlite3_context*, const void*, int,void(*)(void*));
void sqlite3_result_value(sqlite3_context*, sqlite3_value*);
void sqlite3_result_pointer(sqlite3_context*, void*,const char*,void(*)(void*));
void sqlite3_result_zeroblob(sqlite3_context*, int n);
int sqlite3_result_zeroblob64(sqlite3_context*, sqlite3_uint64 n);

这些例程由实现SQL函数和聚合的xFunc或xFinal回调使用。有关更多信息,请参见sqlite3_create_function()和sqlite3_create_function16()。

这些函数非常像用于将值绑定到主机参数的函数的参数绑定系列函数。请参阅SQL参数文档以获取更多信息。

sqlite3_result_blob()接口将应用程序定义的函数的结果设置为BLOB,其内容由第二个参数指向,并且其长度为N个字节,其中N是第三个参数。

sqlite3_result_zeroblob(C,N)和sqlite3_result_zeroblob64(C`,N)接口将应用程序定义函数的结果设置为包含全零字节和N字节大小的BLOB。

sqlite3_result_double()接口将应用程序定义函数的结果设置为第二个参数指定的浮点值。

sqlite3_result_error()和sqlite3_result_error16()函数会导致实现的SQL函数抛出异常。SQLite使用sqlite3_result_error()或sqlite3_result_error16()的第二个参数指向的字符串作为错误消息的文本。SQLite将来自sqlite3_result_error()的错误消息字符串解释为UTF-8。SQLite以本地字节顺序将来自sqlite3_result_error16()的字符串解释为UTF-16。如果sqlite3_result_error()或sqlite3_result_error16()的第三个参数是负数,那么SQLite将通过第一个零字符作为错误消息将所有文本向上。如果sqlite3_result_error()或sqlite3_result_error16()的第三个参数是非负数,那么SQLite会将第二个参数中的很多字节(不是字符)作为错误消息。sqlite3_result_error()和sqlite3_result_error16()例程在返回之前创建错误消息文本的私人副本。因此,调用函数可以在返回之后释放或修改文本而不会造成伤害。sqlite3_result_error_code()函数更改SQLite返回的错误代码,作为函数错误的结果。默认情况下,错误代码是SQLITE_ERROR。随后调用sqlite3_result_error()或sqlite3_result_error16()将错误代码重置为SQLITE_ERROR。

sqlite3_result_error_toobig()接口导致SQLite抛出一个错误,指示字符串或BLOB太长而无法表示。

sqlite3_result_error_nomem()接口导致SQLite抛出一个错误,指出内存分配失败。

sqlite3_result_int()接口将应用程序定义函数的返回值设置为第二个参数中给出的32位有符号整数值。sqlite3_result_int64()接口将应用程序定义的函数的返回值设置为第二个参数中给出的64位有符号整数值。

sqlite3_result_null()接口将应用程序定义的函数的返回值设置为NULL。

sqlite3_result_text(),sqlite3_result_text16(),sqlite3_result_text16le()和sqlite3_result_text16be()接口将应用程序定义的函数的返回值设置为文本字符串,该字符串表示为UTF-8,UTF-16本机字节顺序,UTF- 16个小端,或UTF-16大端。sqlite3_result_text64()接口将应用程序定义的函数的返回值设置为由第五个(和最后一个)参数指定的编码中的文本字符串,该参数必须是SQLITE_UTF8,SQLITE_UTF16,SQLITE_UTF16BE或SQLITE_UTF16LE之一。SQLite从sqlite3_result_text *接口的第二个参数中获取来自应用程序的文本结果。如果sqlite3_result_text *接口的第三个参数是负数,那么SQLite将通过第一个零字符从第二个参数中获取结果文本。如果sqlite3_result_text *接口的第三个参数是非负数,则第二个参数指向的文本的字节数(非字符)将被视为应用程序定义的函数结果。如果第三个参数是非负数,那么它必须是NUL终止符出现的字符串的字节偏移量,如果NUL终止的字符串。如果在小于第三个参数的字节偏移量的字符串中出现任何NUL字符,则结果字符串将包含嵌入式NUL,并且对具有嵌入式NUL的字符串操作的表达式的结果是未定义的。如果sqlite3_result_text * interfaces或sqlite3_result_blob的第四个参数是非空指针,则SQLite在完成使用该结果时将该函数作为文本或BLOB结果的析构函数调用。如果sqlite3_result_text * interfaces或sqlite3_result_blob的第四个参数是特殊常量SQLITE_STATIC,则SQLite会假定文本或BLOB结果位于恒定空间中,并且不会复制参数的内容,也不会在内容具有相应的内容时调用析构函数完成使用该结果。如果sqlite3_result_text * interfaces或sqlite3_result_blob的第4个参数是特殊常量SQLITE_TRANSIENT,则SQLite在返回之前将结果的副本作为从sqlite3_malloc()获取的空间的副本。

sqlite3_result_value()接口将应用程序定义的函数的结果设置为第二个参数指定的未受保护的sqlite3_value对象的副本。sqlite3_result_value()接口创建了sqlite3_value的副本,以便在sqlite3_result_value()返回而没有伤害之后,参数中指定的sqlite3_value可能会更改或解除分配。受保护的sqlite3_value对象可能总是在需要不受保护的sqlite3_value对象的情况下使用,因此任何一种sqlite3_value对象都可以与此接口一起使用。

sqlite3_result_pointer(C,P,T,D)接口将结果设置为一个SQL NULL值,就像sqlite3_result_null(C)一样,除了它还将主机语言指针P或T与该NULL值相关联,可以使用sqlite3_value_pointer()在应用程序定义的SQL函数中检索。如果D参数不是NULL,那么它是一个指向P参数的析构函数的指针。SQLite用P完成时,SQLite调用D作为其唯一参数.T参数应该是一个静态字符串,最好是一个字符串文字。sqlite3_result_pointer()例程是为SQLite 3.20.0添加的指针传递接口的一部分。

如果这些例程是在不同于包含接收sqlite3_context指针的应用程序定义函数的线程中调用的,那么结果是未定义的。

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.Convenience Routines For Running Queries
31.Copy And Free SQL Values
32.Count The Number Of Rows Modified
33.Create Or Redefine SQL Functions
34.Custom Page Cache Object
35.Data Change Notification Callbacks
36.Database Connection Configuration Options
37.Database Connection For Functions
38.Database Connection Handle
39.Database Connection Status
40.Database Snapshot
41.Declare The Schema Of A Virtual Table
42.Declared Datatype Of A Query Result
43.Define New Collating Sequences
44.Deprecated Functions
45.Deprecated Soft Heap Limit Interface
46.Destroy A Prepared Statement Object
47.Destroy a snapshot
48.Determine if a database is read-only
49.Determine If A Prepared Statement Has Been Reset
50.Determine If An SQL Statement Is Complete
51.Determine If An SQL Statement Writes The Database
52.Determine The Virtual Table Conflict Policy
53.Device Characteristics
54.Dynamically Typed Value Object
55.Enable Or Disable Extended Result Codes
56.Enable Or Disable Extension Loading
57.Enable Or Disable Shared Pager Cache
58.Error Codes And Messages
59.Error Logging Interface
60.Evaluate An SQL Statement
61.Experimental Interfaces
62.Extended Result Codes
63.Extract Metadata About A Column Of A Table
64.File Locking Levels
65.Find The Database Handle Of A Prepared Statement
66.Find the next prepared statement
67.Finding The Subtype Of SQL Values
68.Flags For File Open Operations
69.Flags for the xAccess VFS method
70.Flags for the xShmLock VFS method
71.Flush caches to disk mid-transaction
72.Formatted String Printing Functions
73.Free Memory Used By A Database Connection
74.Function Auxiliary Data
75.Function Flags
76.Fundamental Datatypes
77.Impose A Limit On Heap Size
78.Index Of A Parameter With A Given Name
79.Initialize The SQLite Library
80.Interrupt A Long-Running Query
81.Introduction
82.Last Insert Rowid
83.List Of SQLite Constants
84.List Of SQLite Functions
85.List Of SQLite Objects
86.Load An Extension
87.Loadable Extension Thunk
88.Low-Level Control Of Database Files
89.Low-level system error code
90.Maximum xShmLock index
91.Memory Allocation Routines
92.Memory Allocation Subsystem
93.Memory Allocator Statistics
94.Move a BLOB Handle to a New Row
95.Mutex Handle
96.Mutex Methods Object
97.Mutex Types
98.Mutex Verification Routines
99.Mutexes
100.Name Of A Host Parameter
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