int sqlite3_status( int option, int *current, int *highest, int reset );
option
The status option to retrieve.
current
A reference to an integer. The current value will be passed back using this reference.
highest
A reference to an integer. The highest seen value will be passed back using this reference.
reset
If this flag is nonzero, the high-water mark will be reset to the current value after the current high-water mark value is returned.
An SQLite result code.
This function retrieves status information from the SQLite library. When an application requests a specific status option, both the current and the highest seen value are passed back. The application can optionally reset the highest seen value to the current value.
The available options include several different memory monitors, as well as information on the page cache. For a full list of the currently supported options, see http://www.sqlite.org/c3ref/c_status_malloc_size.html.