*** DRAFT ***

SQLite Requirement Matrix Details
errcode.html

Index Summary Markup Original


R-02348-55344-32378-57138-47141-59055-59036-53991 tcl slt th3 src

If the most recent sqlite3_* API call associated with database connection D failed, then the sqlite3_errcode(D) interface returns the numeric result code or extended result code for that API call.

/* IMP: R-02348-55344 */
# EVIDENCE-OF: R-02348-55344 If the most recent sqlite3_* API call
# associated with database connection D failed, then the
# sqlite3_errcode(D) interface returns the numeric result code or
# extended result code for that API call.

R-34293-31480-01160-31597-61187-16604-15204-31151 tcl slt th3 src

The sqlite3_extended_errcode() interface is the same except that it always returns the extended result code even when extended result codes are disabled.

/* IMP: R-34293-31480 */
# EVIDENCE-OF: R-34293-31480 The sqlite3_extended_errcode() interface is
# the same except that it always returns the extended result code even
# when extended result codes are disabled.

R-26145-35631-18411-10408-27137-14285-36971-04977 tcl slt th3 src

The sqlite3_errmsg() and sqlite3_errmsg16() return English-language text that describes the error, as either UTF-8 or UTF-16 respectively.

/* IMP: R-26145-35631 */
# EVIDENCE-OF: R-26145-35631 The sqlite3_errmsg() and sqlite3_errmsg16()
# return English-language text that describes the error, as either UTF-8
# or UTF-16 respectively.

R-24691-27369-29687-09464-65253-51469-13435-14358 tcl slt th3 src

Memory to hold the error message string is managed internally. The application does not need to worry about freeing the result. However, the error string might be overwritten or deallocated by subsequent calls to other SQLite interface functions.

/* IMP: R-24691-27369 */
# EVIDENCE-OF: R-24691-27369 Memory to hold the error message string is
# managed internally. The application does not need to worry about
# freeing the result. However, the error string might be overwritten or
# deallocated by subsequent calls to other SQLite interface functions.

R-26304-43698-14397-16826-05465-17486-47171-40397 tcl slt th3 src

The sqlite3_errstr() interface returns the English-language text that describes the result code, as UTF-8.

/* IMP: R-26304-43698 */
# EVIDENCE-OF: R-26304-43698 The sqlite3_errstr() interface returns the
# English-language text that describes the result code, as UTF-8.

R-30967-33251-18681-38633-21419-53092-54100-57767 tcl slt th3 src

Memory to hold the error message string is managed internally and must not be freed by the application

/* IMP: R-30967-33251 */
# EVIDENCE-OF: R-30967-33251 Memory to hold the error message string is
# managed internally and must not be freed by the application

R-23060-16144-43919-63172-13824-54748-14505-35052 tcl slt th3 src

If the most recent error references a specific token in the input SQL, the sqlite3_error_offset() interface returns the byte offset of the start of that token.

/* IMP: R-23060-16144 */
# EVIDENCE-OF: R-23060-16144 If the most recent error references a
# specific token in the input SQL, the sqlite3_error_offset() interface
# returns the byte offset of the start of that token.

R-59503-11389-21746-10507-19087-49322-11326-26994 tcl slt th3 src

The byte offset returned by sqlite3_error_offset() assumes that the input SQL is UTF8.

/* IMP: R-59503-11389 */
# EVIDENCE-OF: R-59503-11389 The byte offset returned by
# sqlite3_error_offset() assumes that the input SQL is UTF8.

R-41140-09385-47977-21306-28436-51291-32459-07253 tcl slt th3 src

If the most recent error does not reference a specific token in the input SQL, then the sqlite3_error_offset() function returns -1.

/* IMP: R-41140-09385 */
# EVIDENCE-OF: R-41140-09385 If the most recent error does not reference
# a specific token in the input SQL, then the sqlite3_error_offset()
# function returns -1.