Updated: 2022/Sep/29

Please read Privacy Policy. It's for your privacy.


SQLITE3_STMT_BUSY(3)       Library Functions Manual       SQLITE3_STMT_BUSY(3)

NAME
     sqlite3_stmt_busy - Determine If A Prepared Statement Has Been Reset

SYNOPSIS
     int
     sqlite3_stmt_busy(sqlite3_stmt*);

DESCRIPTION
     The sqlite3_stmt_busy(S) interface returns true (non-zero) if the
     prepared statement S has been stepped at least once using sqlite3_step(S)
     but has neither run to completion (returned SQLITE_DONE from
     sqlite3_step(S)) nor been reset using sqlite3_reset(S).  The
     sqlite3_stmt_busy(S) interface returns false if S is a NULL pointer.  If
     S is not a NULL pointer and is not a pointer to a valid prepared
     statement object, then the behavior is undefined and probably
     undesirable.

     This interface can be used in combination sqlite3_next_stmt() to locate
     all prepared statements associated with a database connection that are in
     need of being reset.  This can be used, for example, in diagnostic
     routines to search for prepared statements that are holding a transaction
     open.

SEE ALSO
     sqlite3_stmt(3), sqlite3_next_stmt(3), SQLITE_OK(3)

NetBSD 9.99                    December 19, 2018                   NetBSD 9.99