*** DRAFT ***

SQLite Requirement Matrix Details
progress_handler.html

Index Summary Markup Original


R-60559-41810-33396-14685-52832-17443-15873-34854 tcl slt th3 src

The sqlite3_progress_handler(D,N,X,P) interface causes the callback function X to be invoked periodically during long running calls to sqlite3_step() and sqlite3_prepare() and similar for database connection D.

th3/req1/progress01.test:58

/* IMP: R-60559-41810 */
# EVIDENCE-OF: R-60559-41810 The sqlite3_progress_handler(D,N,X,P)
# interface causes the callback function X to be invoked periodically
# during long running calls to sqlite3_step() and sqlite3_prepare() and
# similar for database connection D.

R-41004-58299-09133-05321-11963-32065-55865-10893 tcl slt th3 src

The parameter P is passed through as the only parameter to the callback function X.

th3/req1/progress01.test:63

/* IMP: R-41004-58299 */
# EVIDENCE-OF: R-41004-58299 The parameter P is passed through as the
# only parameter to the callback function X.

R-47237-20641-51298-30597-19533-32249-45130-16580 tcl slt th3 src

The parameter N is the approximate number of virtual machine instructions that are evaluated between successive invocations of the callback X.

th3/req1/progress01.test:137

/* IMP: R-47237-20641 */
# EVIDENCE-OF: R-47237-20641 The parameter N is the approximate number
# of virtual machine instructions that are evaluated between successive
# invocations of the callback X.

R-22338-33270-38633-54292-24133-20932-49452-38355 tcl slt th3 src

If N is less than one then the progress handler is disabled.

th3/req1/progress01.test:134

/* IMP: R-22338-33270 */
# EVIDENCE-OF: R-22338-33270 If N is less than one then the progress
# handler is disabled.

R-35765-61623-59690-19582-04854-45693-22489-08520 tcl slt th3 src

Only a single progress handler may be defined at one time per database connection; setting a new progress handler cancels the old one.

th3/req1/progress01.test:110

/* IMP: R-35765-61623 */
# EVIDENCE-OF: R-35765-61623 Only a single progress handler may be
# defined at one time per database connection; setting a new progress
# handler cancels the old one.

R-55398-57340-09635-03247-16694-08409-20914-48585 tcl slt th3 src

Setting parameter X to NULL disables the progress handler.

th3/req1/progress01.test:121

/* IMP: R-55398-57340 */
# EVIDENCE-OF: R-55398-57340 Setting parameter X to NULL disables the
# progress handler.

R-39556-50570-30565-00761-35102-37425-01790-22325 tcl slt th3 src

The progress handler is also disabled by setting N to a value less than 1.

th3/req1/progress01.test:131

/* IMP: R-39556-50570 */
# EVIDENCE-OF: R-39556-50570 The progress handler is also disabled by
# setting N to a value less than 1.

R-18444-13968-40811-25945-54439-20224-30854-05072 tcl slt th3 src

If the progress callback returns non-zero, the operation is interrupted.

th3/req1/progress01.test:174

/* IMP: R-18444-13968 */
# EVIDENCE-OF: R-18444-13968 If the progress callback returns non-zero,
# the operation is interrupted.