38 lines
1.2 KiB
Groff
38 lines
1.2 KiB
Groff
.Dd December 19, 2018
|
|
.Dt SQLITE3CHANGESET_CONFLICT 3
|
|
.Os
|
|
.Sh NAME
|
|
.Nm sqlite3changeset_conflict
|
|
.Nd Obtain Conflicting Row Values From A Changeset Iterator
|
|
.Sh SYNOPSIS
|
|
.Ft int
|
|
.Fo sqlite3changeset_conflict
|
|
.Fa "sqlite3_changeset_iter *pIter"
|
|
.Fa "int iVal"
|
|
.Fa "sqlite3_value **ppValue "
|
|
.Fc
|
|
.Sh 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.
|
|
.Pp
|
|
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.
|
|
.Pp
|
|
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.
|
|
.Pp
|
|
If some other error occurs (e.g.
|
|
an OOM condition), an SQLite error code is returned and *ppValue is
|
|
set to NULL.
|
|
.Sh SEE ALSO
|
|
.Xr sqlite3changeset_apply 3 ,
|
|
.Xr SQLITE_CHANGESET_DATA 3 ,
|
|
.Xr SQLITE_OK 3
|