SQLITE3_STMT_BUSY(3)

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)

March 11, 2017 | NetBSD 8.3