Small. Fast. Reliable.
Choose any three.

SQLite C接口

功能辅助数据

void * sqlite3_get_auxdata（sqlite3_context *，int N）;
void sqlite3_set_auxdata（sqlite3_context *，int N，void *，void（*）（void *））;

这些函数可由（非聚合）SQL函数用于将元数据与参数值相关联。如果在查询执行期间将相同的值传递给同一SQL函数的多个调用，则在某些情况下，可能会保留关联的元数据。正则表达式匹配函数中的一个示例。正则表达式的编译版本可以存储为与模式字符串关联的元数据。然后，只要模式字符串保持不变，就可以在同一函数的多次调用中重用已编译的正则表达式。

sqlite3_get_auxdata（C，N）接口返回指向由sqlite3_set_auxdata（C，N，P，X）函数关联的元数据的指针，其中第N个自变量值为应用程序定义的函数。对于最左边的函数参数，N为零。如果没有与该函数参数关联的元数据，则sqlite3_get_auxdata（C，N）接口返回NULL指针。

sqlite3_set_auxdata（C，N，P，X）接口将P保存为应用程序定义函数的第N个参数的元数据。如果元数据仍然有效，则对sqlite3_get_auxdata（C，N）的后续调用从最近的sqlite3_set_auxdata（C，N，P，X）调用返回P，如果元数据已被丢弃，则返回NULL。在每次调用sqlite3_set_auxdata（C，N，P，X）（其中X不为NULL）之后，当丢弃元数据时，SQLite将使用参数P精确地调用析构函数X一次。SQLite可以随时随意丢弃元数据，包括：

特别要注意最后一个项目符号。在sqlite3_set_auxdata（）接口甚至返回之前，可以立即调用sqlite3_set_auxdata（C，N，P，X）中的析构函数X。因此，应在函数实现的结尾附近调用sqlite3_set_auxdata（），并且在调用sqlite3_set_auxdata（）之后，函数实现不应使用P。

实际上，元数据是在函数调用的函数调用之间保留的，这些函数参数是编译时常量，包括文字值和参数以及由它们组成的表达式。

这些接口的N参数的值应为非负数。将来的增强功能可能会使用负N值来定义新类型的功能缓存行为。

这些例程必须从运行SQL函数的同一线程中调用。

另请参见 对象， 常量和 函数的列表。