sqlite3 第五章—扩展API

　　SQLite C API 中扩展API支持用户自定义函数、聚合和排序规则。用户自定义函数就是映射到用户自己用C语言或其他语言实现的SQL函数。

　　自定义扩展必须一对一注册到连接，因为他们存在于程序内存中。当程序或脚本启动时，为计划使用自定义扩展的连接负责这侧所需的扩展。

一、创建用户自定义函数

1. 编写处理程序。实现想要SQL执行的事情。
2. 注册处理程序。提供SQL名称、参数个数及指向该处理程序的指针。

//注册函数，第五个参数“任意指针”，不知道做什么用。
sqlite3_create_function(db, "hello_newman", 0, SQLITE_UTF8, NULL,hello_newman,NULL,NULL);

//自定义函数
void hello_newman(sqlite3_context* ctx, int nargs, sqlite3_value** values)
{
    const char *msg = "Hello Jerry";

    sqlite3_result_text(ctx, msg, strlen(msg), SQLITE_STATIC);
}

　　需要说明的是，如果要在app中看到结果，需要使用回调函数或sqlite3_get_table()，把结果打印出来。

二、创建用户自定义聚合

　　聚合函数适用于结果集中的所有记录，并从中计算某种聚合值的函数。如sum()、count()、avg()都是标准的SQL聚合函数。

　　自定义聚合需要三步：

1. 注册聚合
2. 实现结果集中每个记录调用的步骤函数
3. 实现结果处理后调用的完成函数

　　下面实现了一个称为pysum的简单SUM()聚合例子。

#!/usr/bin/env python

import apsw, string

connection=apsw.Connection("seinfeld.db")

#步骤2
def step(context, *args):
    context['value'] += args[0]
        
def finalize(context):
    return context['value']

def pysum():
    
    return ({'value' : 0}, step, finalize)

#步骤1
connection.createaggregatefunction("pysum", pysum)

#步骤3
c = connection.cursor()
print c.execute("select pysum(id) from foods").next()[0]

三、创建用户自定义排序

 　　sqlite3_create_collation()

　　 通过上述API提供用户自定义排序规则，提供一种不同文本比较和排序方法。SQLite提供了三种默认排序规则：BINARY、NOCASE、RTRIM。

　　BINARY使用memcmp()比较字符串值，NOCASE区分大小写，RTRIM忽略尾随空格。