创建新的 Changegroup 对象

小巧。快速。可靠。
三选二。

Session 模块 C 接口

创建新的 Changegroup 对象

int sqlite3changegroup_new(sqlite3_changegroup **pp);

sqlite3_changegroup 对象用于将两个或多个变更集（或补丁集）组合成单个变更集（或补丁集）。单个 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()。

另请参阅对象、常量和函数列表。