Small. Fast. Reliable.
Choose any three.

会话模块C接口

完成变更集迭代器

int sqlite3changeset_finalize(sqlite3_changeset_iter * pIter);

此函数用于完成分配有sqlite3changeset_start()的迭代器 。

仅应在使用sqlite3changeset_start()函数创建的迭代器上调用此 函数。如果应用程序通过sqlite3changeset_apply()传递给冲突处理程序的迭代器调用此函数 ,则SQLITE_MISUSE将立即返回,且该调用无效。

如果已到sqlite3changeset_xxx()函数的调用(例如一个内遇到一个错误SQLITE_CORRUPTsqlite3changeset_next()SQLITE_NOMEMsqlite3changeset_new() ),则对应于该错误的错误代码由该函数返回。否则,返回SQLITE_OK。这是为了允许以下模式(伪代码):

  sqlite3changeset_start();
  while(SQLITE_ROW == sqlite3changeset_next()){
    //做些改变。
  }
  rc = sqlite3changeset_finalize();
  if(rc!= SQLITE_OK){
    // 发生了错误 
  }

另请参见 对象常量函数的列表