summaryrefslogtreecommitdiff
path: root/static/netbsd/man3/sqlite3changeset_conflict.3
diff options
context:
space:
mode:
Diffstat (limited to 'static/netbsd/man3/sqlite3changeset_conflict.3')
-rw-r--r--static/netbsd/man3/sqlite3changeset_conflict.348
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