_SQlite中文网

Small. Fast. Reliable.
Choose any three.

会话模块C接口

创建一个新的变更组对象

int sqlite3changegroup_new（sqlite3_changegroup ** pp）;

sqlite3_changegroup对象用于将两个或多个变更集（或补丁集）组合为一个变更集（或补丁集）。单个变更组对象可以组合变更集或补丁集，但不能两者都组合。输出始终与输入具有相同的格式。

如果成功，此函数将返回SQLITE_OK，并在返回前使用指向新sqlite3_changegroup对象的指针填充（* pp）。调用者最终应使用对sqlite3changegroup_delete（）的调用来释放返回的对象。如果发生错误，则返回SQLite错误代码（即SQLITE_NOMEM），并将* pp设置为NULL。

sqlite3_changegroup对象的常用用法如下：

它是通过调用sqlite3changegroup_new（）创建的。
通过调用sqlite3changegroup_add（），将零个或多个变更集（或补丁集）添加到对象。
应用程序通过调用sqlite3changegroup_output（）获得所有输入变更集组合在一起的结果。
使用对sqlite3changegroup_delete（）的调用删除该对象。

在对new（）和delete（）的调用之间可以以任意顺序进行对add（）和output（）的任意数量的调用。

除了常规的sqlite3changegroup_add（）和sqlite3changegroup_output（）函数外，还提供流式版本sqlite3changegroup_add_strm（）和sqlite3changegroup_output_strm（）。

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