Создание нового объекта Changegroup

int sqlite3changegroup_new(sqlite3_changegroup **pp);

Объект sqlite3_changegroup используется для объединения двух или более наборов изменений (или наборов исправлений) в один набор изменений (или набор исправлений). Один объект changegroup может объединять наборы изменений или наборы исправлений, но не оба одновременно. Результат всегда имеет тот же формат, что и входные данные.

При успешном выполнении функция возвращает SQLITE_OK и заполняет (*pp) указателем на новый объект sqlite3_changegroup перед возвратом. Вызывающая сторона должна в конечном итоге освободить возвращенный объект, используя вызов sqlite3changegroup_delete(). Если произошла ошибка, возвращается код ошибки SQLite (например, SQLITE_NOMEM), а *pp устанавливается в значение NULL.

Обычный шаблон использования объекта sqlite3_changegroup следующий:

• Он создается с помощью вызова sqlite3changegroup_new().

• Ноль или более наборов изменений (или наборов исправлений) добавляются в объект с помощью вызова sqlite3changegroup_add().

• Результат объединения всех входных наборов изменений получается приложением с помощью вызова sqlite3changegroup_output().

• Объект удаляется с помощью вызова sqlite3changegroup_delete().

Любое количество вызовов add() и output() может быть сделано между вызовами new() и delete(), и в любом порядке.

Помимо обычных функций sqlite3changegroup_add() и sqlite3changegroup_output(), также доступны потоковые версии sqlite3changegroup_add_strm() и sqlite3changegroup_output_strm().

См. также списки Объектов, Констант и Функций.