xref: /netbsd-src/external/public-domain/sqlite/man/sqlite3session_isempty.3 (revision bdc22b2e01993381dcefeff2bc9b56ca75a4235c)
1.Dd March 11, 2017
2.Dt SQLITE3SESSION_ISEMPTY 3
3.Os
4.Sh NAME
5.Nm sqlite3session_isempty
6.Nd Test if a changeset has recorded any changes.
7.Sh SYNOPSIS
8.Ft int
9.Fo sqlite3session_isempty
10.Fa "sqlite3_session *pSession"
11.Fc
12.Sh DESCRIPTION
13Return non-zero if no changes to attached tables have been recorded
14by the session object passed as the first argument.
15Otherwise, if one or more changes have been recorded, return zero.
16.Pp
17Even if this function returns zero, it is possible that calling sqlite3session_changeset()
18on the session handle may still return a changeset that contains no
19changes.
20This can happen when a row in an attached table is modified and then
21later on the original values are restored.
22However, if this function returns non-zero, then it is guaranteed that
23a call to sqlite3session_changeset() will return a changeset containing
24zero changes.
25.Sh SEE ALSO
26.Xr sqlite3session_changeset 3
27