From 63847496f14c813a5d80efd5b7de0f1294ffe1e3 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 13 Apr 2024 16:07:11 +0200 Subject: Adding upstream version 3.45.1. Signed-off-by: Daniel Baumann --- www/session/sqlite3changeset_new.html | 151 ++++++++++++++++++++++++++++++++++ 1 file changed, 151 insertions(+) create mode 100644 www/session/sqlite3changeset_new.html (limited to 'www/session/sqlite3changeset_new.html') diff --git a/www/session/sqlite3changeset_new.html b/www/session/sqlite3changeset_new.html new file mode 100644 index 0000000..1fb8f10 --- /dev/null +++ b/www/session/sqlite3changeset_new.html @@ -0,0 +1,151 @@ + + + + + +Obtain new.* Values From A Changeset Iterator + + + +
+ + + +
+
+Small. Fast. Reliable.
Choose any three. +
+
+ +
+ +
+
+ + + +
+
+
+ +

Session Module C Interface

Obtain new.* Values From A Changeset Iterator

int sqlite3changeset_new(
+  sqlite3_changeset_iter *pIter,  /* Changeset iterator */
+  int iVal,                       /* Column number */
+  sqlite3_value **ppValue         /* OUT: New value (or NULL pointer) */
+);
+

+The pIter argument passed to this function may either be an iterator +passed to a conflict-handler by sqlite3changeset_apply(), or an iterator +created by sqlite3changeset_start(). In the latter case, the most recent +call to sqlite3changeset_next() must have returned SQLITE_ROW. +Furthermore, it may only be called if the type of change that the iterator +currently points to is either SQLITE_UPDATE or SQLITE_INSERT. Otherwise, +this function returns SQLITE_MISUSE and sets *ppValue 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 vector of +new row values stored as part of the UPDATE or INSERT change and +returns SQLITE_OK. If the change is an UPDATE and does not include +a new value for the requested column, *ppValue is set to NULL and +SQLITE_OK returned. The name of the function comes from the fact that +this is similar to the "new.*" columns available to update or delete +triggers.

+ +

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

See also lists of + Objects, + Constants, and + Functions.

+ -- cgit v1.2.3