Итератор изменений набора изменений

int sqlite3changeset_next(sqlite3_changeset_iter *pIter);

Эта функция может быть использована только с итераторами, созданными функцией sqlite3changeset_start(). Если она вызывается на итераторе, переданном в обратный вызов обработчика конфликтов функцией sqlite3changeset_apply(), возвращается SQLITE_MISUSE, и вызов не оказывает никакого эффекта.

Сразу после создания итератора функцией sqlite3changeset_start() он не указывает на какие-либо изменения в наборе изменений. Предполагая, что набор изменений не пуст, первый вызов этой функции перемещает итератор к первому изменению в наборе изменений. Каждый последующий вызов перемещает итератор к следующему изменению в наборе изменений (если таковое есть). Если ошибка не возникает и итератор указывает на действительное изменение после вызова sqlite3changeset_next(), возвращается SQLITE_ROW. В противном случае, если все изменения в наборе изменений уже посещены, возвращается SQLITE_DONE.

Если возникает ошибка, возвращается код ошибки SQLite. Возможные коды ошибок включают SQLITE_CORRUPT (если буфер набора изменений поврежден) или SQLITE_NOMEM.

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