SQLITE3SESSION_ISEMPTY(3) | Library Functions Manual | SQLITE3SESSION_ISEMPTY(3)

# NAME

`sqlite3session_isempty` — test if a changeset has recorded any changes

# SYNOPSIS

`#include <sqlite3.h>`

int
`sqlite3session_isempty`(sqlite3_session *pSession);

# DESCRIPTION

Return non-zero if no changes to attached tables have been recorded by the session object passed as the first argument. Otherwise, if one or more changes have been recorded, return zero.

Even if this function returns zero, it is possible that calling `sqlite3session_changeset`() on the session handle may still return a changeset that contains no changes. This can happen when a row in an attached table is modified and then later on the original values are restored. However, if this function returns non-zero, then it is guaranteed that a call to sqlite3session_changeset() will return a changeset containing zero changes.

# IMPLEMENTATION NOTES

These declarations were extracted from the interface documentation at line 11410.

    SQLITE_API int sqlite3session_isempty(sqlite3_session *pSession);

# SEE ALSO

sqlite3session_changeset(3)

January 24, 2024 | NetBSD 11.0