.Dd January 24, 2024
.Dt SQLITE3_TXN_STATE 3
.Os
.Sh NAME
.Nm sqlite3_txn_state
.Nd determine the transaction state of a database
.Sh SYNOPSIS
.In sqlite3.h
.Ft int
.Fo sqlite3_txn_state
.Fa "sqlite3*"
.Fa "const char *zSchema"
.Fc
.Sh DESCRIPTION
The sqlite3_txn_state(D,S) interface returns the current transaction state
of schema S in database connection D.
If S is NULL, then the highest transaction state of any schema on database
connection D is returned.
Transaction states are (in order of lowest to highest):
.Bl -enum
.It
SQLITE_TXN_NONE
.It
SQLITE_TXN_READ
.It
SQLITE_TXN_WRITE
.El
.Pp
If the S argument to sqlite3_txn_state(D,S) is not the name of a valid
schema, then -1 is returned.
.Sh IMPLEMENTATION NOTES
These declarations were extracted from the
interface documentation at line 6655.
.Bd -literal
SQLITE_API int sqlite3_txn_state(sqlite3*,const char *zSchema);
.Ed
.Sh SEE ALSO
.Xr SQLITE_TXN_NONE 3