SQLITE3_PROGRESS_HANDLER(3) | Library Functions Manual | SQLITE3_PROGRESS_HANDLER(3) |
sqlite3_progress_handler
—
sqlite3_progress_handler
(sqlite3*,
int, int(*)(void*),
void*);
The parameter P is passed through as the only parameter to the callback function X. The parameter N is the approximate number of virtual machine instructions that are evaluated between successive invocations of the callback X. If N is less than one then the progress handler is disabled.
Only a single progress handler may be defined at one time per database connection; setting a new progress handler cancels the old one. Setting parameter X to NULL disables the progress handler. The progress handler is also disabled by setting N to a value less than 1.
If the progress callback returns non-zero, the operation is interrupted. This feature can be used to implement a "Cancel" button on a GUI progress dialog box.
The progress handler callback must not do anything that will modify the database connection that invoked the progress handler. Note that sqlite3_prepare_v2() and sqlite3_step() both modify their database connections for the meaning of "modify" in this paragraph.
December 19, 2018 | NetBSD 9.0 |