.Dd December 19, 2018
.Dt SQLITE3SESSION_TABLE_FILTER 3
.Os
.Sh NAME
.Nm sqlite3session_table_filter
.Nd Set a table filter on a Session Object.
.Sh SYNOPSIS
.Ft void 
.Fo sqlite3session_table_filter
.Fa "sqlite3_session *pSession"
.Fa "int(*xFilter)( void *pCtx,                   const char *zTab              )"
.Fa "void *pCtx                      "
.Fc
.Sh DESCRIPTION
The second argument (xFilter) is the "filter callback".
For changes to rows in tables that are not attached to the Session
object, the filter is called to determine whether changes to the table's
rows should be tracked or not.
If xFilter returns 0, changes is not tracked.
Note that once a table is attached, xFilter will not be called again.