建立新的變更群組物件

小巧、快速、可靠。
任選三項。

Session 模組 C 介面

建立新的變更群組物件

int sqlite3changegroup_new(sqlite3_changegroup **pp);

sqlite3_changegroup 物件用於將兩個或多個變更集（或修補程式集）合併成單一變更集（或修補程式集）。單一變更群組物件可以合併變更集或修補程式集，但不能同時合併兩者。輸出格式永遠與輸入格式相同。

如果成功，此函式會傳回 SQLITE_OK，並在傳回前將 (*pp) 填入指向新的 sqlite3_changegroup 物件的指標。呼叫者最終應使用呼叫 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()。

另請參閱物件、常數和函式清單。