diff options
Diffstat (limited to 'static/netbsd/man3/sqlite3changeset_conflict.3')
| -rw-r--r-- | static/netbsd/man3/sqlite3changeset_conflict.3 | 48 |
1 files changed, 48 insertions, 0 deletions
diff --git a/static/netbsd/man3/sqlite3changeset_conflict.3 b/static/netbsd/man3/sqlite3changeset_conflict.3 new file mode 100644 index 00000000..897c5e80 --- /dev/null +++ b/static/netbsd/man3/sqlite3changeset_conflict.3 @@ -0,0 +1,48 @@ +.Dd January 24, 2024 +.Dt SQLITE3CHANGESET_CONFLICT 3 +.Os +.Sh NAME +.Nm sqlite3changeset_conflict +.Nd obtain conflicting row values from a changeset iterator +.Sh SYNOPSIS +.In sqlite3.h +.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 +.Fn 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 IMPLEMENTATION NOTES +These declarations were extracted from the +interface documentation at line 11664. +.Bd -literal +SQLITE_API int sqlite3changeset_conflict( + sqlite3_changeset_iter *pIter, /* Changeset iterator */ + int iVal, /* Column number */ + sqlite3_value **ppValue /* OUT: Value from conflicting row */ +); +.Ed +.Sh SEE ALSO +.Xr sqlite3changeset_apply 3 , +.Xr SQLITE_CHANGESET_DATA 3 , +.Xr SQLITE_OK 3 |
