NAME
sqlite3changeset_conflict —
Obtain
Conflicting Row Values From A Changeset Iterator
SYNOPSIS
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.
SEE ALSO
sqlite3changeset_apply(3),
SQLITE_CHANGESET_DATA(3),
SQLITE_OK(3)