sqlite3changeset_next(3) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
SQLITE3CHANGESET_NEX... NetBSD Library Functions ManualSQLITE3CHANGESET_NEX...


NAME

     sqlite3changeset_next -- advance a changeset iterator


SYNOPSIS

     #include <sqlite3.h>

     int
     sqlite3changeset_next(sqlite3_changeset_iter *pIter);


DESCRIPTION

     This function may only be used with iterators created by the function
     sqlite3changeset_start().  If it is called on an iterator passed to a
     conflict-handler callback by sqlite3changeset_apply(), SQLITE_MISUSE is
     returned and the call has no effect.

     Immediately after an iterator is created by sqlite3changeset_start(), it
     does not point to any change in the changeset.  Assuming the changeset is
     not empty, the first call to this function advances the iterator to point
     to the first change in the changeset.  Each subsequent call advances the
     iterator to point to the next change in the changeset (if any).  If no
     error occurs and the iterator points to a valid change after a call to
     sqlite3changeset_next() has advanced it, SQLITE_ROW is returned.  Other-
     wise, if all changes in the changeset have already been visited,
     SQLITE_DONE is returned.

     If an error occurs, an SQLite error code is returned.  Possible error
     codes include SQLITE_CORRUPT (if the changeset buffer is corrupt) or
     SQLITE_NOMEM.


IMPLEMENTATION NOTES

     These declarations were extracted from the interface documentation at
     line 11502.

     SQLITE_API int sqlite3changeset_next(sqlite3_changeset_iter *pIter);


SEE ALSO

     sqlite3changeset_apply(3), sqlite3changeset_start(3)

NetBSD 10.99                   January 24, 2024                   NetBSD 10.99