xref: /netbsd-src/external/public-domain/sqlite/man/sqlite3session_isempty.3 (revision 82d56013d7b633d116a93943de88e08335357a7c)
1.Dd December 19, 2018
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