Завершение итератора изменений

int sqlite3changeset_finalize(sqlite3_changeset_iter *pIter);

Эта функция используется для завершения итератора, выделенного с помощью sqlite3changeset_start().

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

Если при вызове функции sqlite3changeset_xxx() (например, SQLITE_CORRUPT в sqlite3changeset_next() или SQLITE_NOMEM в sqlite3changeset_new()) возникла ошибка, то эта функция возвращает код ошибки, соответствующий этой ошибке. В противном случае возвращается SQLITE_OK. Это позволяет использовать следующий шаблон (псевдокод):

  sqlite3changeset_start();
  while( SQLITE_ROW==sqlite3changeset_next() ){
    // Do something with change.
  }
  rc = sqlite3changeset_finalize();
  if( rc!=SQLITE_OK ){
    // An error has occurred 
  }

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