Skip to main content

read_db_cache_status

Function read_db_cache_status 

Source
pub fn read_db_cache_status(conn: &Connection) -> SqliteCacheStatus
Expand description

Read cumulative page-cache counters from a SQLite connection.

Calls sqlite3_db_status() for CACHE_HIT, CACHE_MISS, CACHE_WRITE, and CACHE_SPILL with resetFlag=0 (non-destructive read).

If any sqlite3_db_status call returns an error, that counter is left at zero rather than propagating garbage. This should not happen with valid connection handles and known status codes, but a database engine must not return misleading data.

§Safety contract

The function is safe because Connection::handle() returns a valid sqlite3* for the connection’s lifetime, and sqlite3_db_status is read-only and thread-safe for the owning connection.