xref: /netbsd-src/external/public-domain/sqlite/man/sqlite3session_isempty.3 (revision 901e7e84758515fbf39dfc064cb0b45ab146d8b0)
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