@H_403_0@扩展 C API
@H_403_0@实现函数、聚合、排序的基本方法是使用回调函数,并在程序中注册,然后在sql中使用。
@H_403_0@函数和聚合使用相同的注册函数和类似的回调函数。用户自定义聚合、函数和排序规则的生命周期是很短的,基于连接注册,不存储在数据库中,需要确保应用程序夹杂了定制扩展并在连接中注册。
@H_403_0@扩展必须在每一个使用它们的连接上注册。
@H_403_0@注册函数:
@H_403_0@ 可以使用sqlite3_create_function()在连接中注册和聚合。(UTF-8和UTF-16版本)
@H_403_0@ int sqlite3_create_function(
@H_403_0@ sqlite * cnx,/*连接句柄*/
@H_403_0@ const char *zFunctionName,/*在sql语句中使用的函数聚合名称*/
@H_403_0@ int nArg,/*参数的格式,-1表示参数的个数不稳定*/
@H_403_0@ int eTextRep,/*编码格式*/
@H_403_0@ void *pUserData,/*传递个回调函数的应用程序数据*/
@H_403_0@ void ( *xFunc )(sqlite3_context *,int,sqlite3_value * ),
@H_403_0@ void ( *xStep)(sqlite3_context *,
@H_403_0@ void ( *xFinal)(sqlite3_context *,sqlite3_value * )
@H_403_0@ );
@H_403_0@ int sqlite3_create_function16(
@H_403_0@ sqlite * cnx,sqlite3_value * )
@H_403_0@ );
@H_403_0@
@H_403_0@
@H_403_0@步骤函数:
@H_403_0@ 他和自定义函数的回调函数一样声明如下:
@H_403_0@ void fn(
@H_403_0@ sqlite3_context * ctx,/*聚合的上下文环境,接受sqlite3_create_function()提供的应用程序数据参数*/
@H_403_0@ int nargs,/*包含传递给函数的参数个数*/
@H_403_0@ sqlite3_value **values
@H_403_0@ );
@H_403_0@ 可以使用sqlite3_user_data()获得用户数据:void *sqlite3_user_data(sqlite3_context * ) ;
@H_403_0@ 聚合通过sqlite3_aggregate_context()为每个实例分配状态: void *sqlite3_aggregate_context( sqlite3_context *,int nBytes);
@H_403_0@
@H_403_0@返回值:
@H_403_0@ 参数value是sqlite3_value结构体数组,是sqlite实际参数值的句柄。这些值的实际数据可以通过sqlite3_value_xxx()获取:
@H_403_0@ xxx sqlite3_value_xxx(sqlite3_value* value) ;
@H_403_0@ 注意他获取标量值和数组值的方式。
@H_403_0@ 函数返回值五种形式。
@H_403_0@函数:page221.
@H_403_0@返回值:page222;
@H_403_0@
@H_403_0@
@H_403_0@数组与内存清理器、错误处理、返回输入值、聚合、注册函数。
@H_403_0@注意排序规则的定义等等。
@H_403_0@
@H_403_0@扩展的许多规则和原来核心API的工作、定义基本一样。