Updated: 2022/Sep/29

Please read Privacy Policy. It's for your privacy.

SQLITE3CHANGESET_CONFLICT(3)                          Library Functions Manual

NAME
     sqlite3changeset_conflict - obtain conflicting row values from a
     changeset iterator

SYNOPSIS
     #include <sqlite3.h>

     int
     sqlite3changeset_conflict(sqlite3_changeset_iter *pIter, int iVal,
         sqlite3_value **ppValue);

DESCRIPTION
     This function should only be used with iterator objects passed to a
     conflict-handler callback by sqlite3changeset_apply() with either
     SQLITE_CHANGESET_DATA or SQLITE_CHANGESET_CONFLICT.  If this function is
     called on any other iterator, SQLITE_MISUSE is returned and *ppValue is
     set to NULL.

     Argument iVal must be greater than or equal to 0, and less than the
     number of columns in the table affected by the current change.
     Otherwise, SQLITE_RANGE is returned and *ppValue is set to NULL.

     If successful, this function sets *ppValue to point to a protected
     sqlite3_value object containing the iVal'th value from the "conflicting
     row" associated with the current conflict-handler callback and returns
     SQLITE_OK.

     If some other error occurs (e.g. an OOM condition), an SQLite error code
     is returned and *ppValue is set to NULL.

IMPLEMENTATION NOTES
     These declarations were extracted from the interface documentation at
     line 11535.

     SQLITE_API int sqlite3changeset_conflict(
       sqlite3_changeset_iter *pIter,  /* Changeset iterator */
       int iVal,                       /* Column number */
       sqlite3_value **ppValue         /* OUT: Value from conflicting row */
     );

SEE ALSO
     sqlite3changeset_apply(3), SQLITE_CHANGESET_DATA(3), SQLITE_OK(3)

NetBSD 10.99                    August 24, 2023                   NetBSD 10.99