Manual Page Result
0
Command: sqlite3changeset_old | Section: 3 | Source: NetBSD | File: sqlite3changeset_old.3
SQLITE3CHANGESET_OLD(3) FreeBSD Library Functions Manual
NAME
sqlite3changeset_old - Obtain old.* Values From A Changeset Iterator
SYNOPSIS
int
sqlite3changeset_old(sqlite3_changeset_iter *pIter, int iVal,
sqlite3_value **ppValue );
DESCRIPTION
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_DELETE or SQLITE_UPDATE.
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
original row values stored as part of the UPDATE or DELETE change and
returns SQLITE_OK. The name of the function comes from the fact that
this is similar to the "old.*" 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
sqlite3changeset_apply(3), sqlite3changeset_next(3),
sqlite3changeset_start(3), SQLITE_CREATE_INDEX(3), SQLITE_OK(3),
SQLITE_CREATE_INDEX(3)
FreeBSD 14.1-RELEASE-p8 December 19, 2018 FreeBSD 14.1-RELEASE-p8