*** DRAFT ***

SQLite Requirement Matrix Details
blob_write.html

Index Summary Markup Original


R-62898-22698-26165-43256-00813-48770-03104-06155 tcl slt th3 src

This function is used to write data into an open BLOB handle from a caller-supplied buffer. N bytes of data are copied from the buffer Z into the open BLOB, starting at offset iOffset.

tcl/e_blobwrite.test:18

/* IMP: R-62898-22698 */
# EVIDENCE-OF: R-62898-22698 This function is used to write data into an
# open BLOB handle from a caller-supplied buffer. N bytes of data are
# copied from the buffer Z into the open BLOB, starting at offset
# iOffset.

R-45864-01884-48942-09518-31331-15179-06601-52827 tcl slt th3 src

On success, sqlite3_blob_write() returns SQLITE_OK. Otherwise, an error code or an extended error code is returned.

tcl/e_blobwrite.test:37

/* IMP: R-45864-01884 */
# EVIDENCE-OF: R-45864-01884 On success, sqlite3_blob_write() returns
# SQLITE_OK. Otherwise, an error code or an extended error code is
# returned.

R-34782-18311-17741-53218-12879-22753-50681-05507 tcl slt th3 src

Unless SQLITE_MISUSE is returned, this function sets the database connection error code and message accessible via sqlite3_errcode() and sqlite3_errmsg() and related functions.

tcl/e_blobwrite.test:82

/* IMP: R-34782-18311 */
# EVIDENCE-OF: R-34782-18311 Unless SQLITE_MISUSE is returned, this
# function sets the database connection error code and message
# accessible via sqlite3_errcode() and sqlite3_errmsg() and related
# functions.

R-63341-57517-64693-29591-34989-59774-15075-48148 tcl slt th3 src

If the BLOB handle passed as the first argument was not opened for writing (the flags parameter to sqlite3_blob_open() was zero), this function returns SQLITE_READONLY.

tcl/e_blobwrite.test:99

/* IMP: R-63341-57517 */
# EVIDENCE-OF: R-63341-57517 If the BLOB handle passed as the first
# argument was not opened for writing (the flags parameter to
# sqlite3_blob_open() was zero), this function returns SQLITE_READONLY.

R-29804-27366-08727-59986-31864-09983-14088-09844 tcl slt th3 src

If offset iOffset is less than N bytes from the end of the BLOB, SQLITE_ERROR is returned and no data is written.

tcl/e_blobwrite.test:108

/* IMP: R-29804-27366 */
# EVIDENCE-OF: R-29804-27366 If offset iOffset is less than N bytes from
# the end of the BLOB, SQLITE_ERROR is returned and no data is written.

R-58570-38916-64955-51139-26033-08534-02981-10292 tcl slt th3 src

If N or iOffset are less than zero SQLITE_ERROR is returned and no data is written.

tcl/e_blobwrite.test:121

/* IMP: R-58570-38916 */
# EVIDENCE-OF: R-58570-38916 If N or iOffset are less than zero
# SQLITE_ERROR is returned and no data is written.

R-20958-54138-45241-50664-65336-36333-30654-63832 tcl slt th3 src

An attempt to write to an expired BLOB handle fails with an error code of SQLITE_ABORT.

tcl/e_blobwrite.test:131

/* IMP: R-20958-54138 */
# EVIDENCE-OF: R-20958-54138 An attempt to write to an expired BLOB
# handle fails with an error code of SQLITE_ABORT.

R-08382-59936-33976-47324-12447-38582-10569-47799 tcl slt th3 src

Writes to the BLOB that occurred before the BLOB handle expired are not rolled back by the expiration of the handle, though of course those changes might have been overwritten by the statement that expired the BLOB handle or by other independent statements.

tcl/e_blobwrite.test:148

/* IMP: R-08382-59936 */
# EVIDENCE-OF: R-08382-59936 Writes to the BLOB that occurred before the
# BLOB handle expired are not rolled back by the expiration of the
# handle, though of course those changes might have been overwritten by
# the statement that expired the BLOB handle or by other independent
# statements.