*** DRAFT ***

SQLite Requirement Matrix Details
load_extension.html

Index Summary Markup Original


R-60090-27861-59192-20728-19782-37127-56669-48134 tcl slt th3 src

This interface loads an SQLite extension library from the named file.

/* IMP: R-60090-27861 */
# EVIDENCE-OF: R-60090-27861 This interface loads an SQLite extension
# library from the named file.

R-13870-45783-04772-14716-53904-46370-14954-15973 tcl slt th3 src

The sqlite3_load_extension() interface attempts to load an SQLite extension library contained in the file zFile.

/* IMP: R-13870-45783 */
# EVIDENCE-OF: R-13870-45783 The sqlite3_load_extension() interface
# attempts to load an SQLite extension library contained in the file
# zFile.

R-27327-54431-40312-06060-63431-19500-57112-52669 tcl slt th3 src

The entry point is zProc.

/* IMP: R-27327-54431 */
# EVIDENCE-OF: R-27327-54431 The entry point is zProc.

R-02718-64874-37028-59587-06155-35657-39180-35629 tcl slt th3 src

zProc may be 0, in which case SQLite will try to come up with an entry point name on its own. It first tries "sqlite3_extension_init". If that does not work, it constructs a name "sqlite3_X_init" where the X is consists of the lower-case equivalent of all ASCII alphabetic characters in the filename from the last "/" to the first following "." and omitting any initial "lib".

/* IMP: R-02718-64874 */
# EVIDENCE-OF: R-02718-64874 zProc may be 0, in which case SQLite will
# try to come up with an entry point name on its own. It first tries
# "sqlite3_extension_init". If that does not work, it constructs a name
# "sqlite3_X_init" where the X is consists of the lower-case equivalent
# of all ASCII alphabetic characters in the filename from the last "/"
# to the first following "." and omitting any initial "lib".

R-38200-45242-44126-59333-52626-62279-09263-45295 tcl slt th3 src

The sqlite3_load_extension() interface returns SQLITE_OK on success and SQLITE_ERROR if something goes wrong.

/* IMP: R-38200-45242 */
# EVIDENCE-OF: R-38200-45242 The sqlite3_load_extension() interface
# returns SQLITE_OK on success and SQLITE_ERROR if something goes wrong.

R-18190-43830-34676-47582-56241-44977-21337-20567 tcl slt th3 src

If an error occurs and pzErrMsg is not 0, then the sqlite3_load_extension() interface shall attempt to fill *pzErrMsg with error message text stored in memory obtained from sqlite3_malloc().

/* IMP: R-18190-43830 */
# EVIDENCE-OF: R-18190-43830 If an error occurs and pzErrMsg is not 0,
# then the sqlite3_load_extension() interface shall attempt to fill
# *pzErrMsg with error message text stored in memory obtained from
# sqlite3_malloc().

R-12482-18070-30469-35511-31025-38188-23401-30246 tcl slt th3 src

Extension loading must be enabled using sqlite3_enable_load_extension() or sqlite3_db_config(db,SQLITE_DBCONFIG_ENABLE_LOAD_EXTENSION,1,NULL) prior to calling this API, otherwise an error will be returned.

/* IMP: R-12482-18070 */
# EVIDENCE-OF: R-12482-18070 Extension loading must be enabled using
# sqlite3_enable_load_extension() or
# sqlite3_db_config(db,SQLITE_DBCONFIG_ENABLE_LOAD_EXTENSION,1,NULL)
# prior to calling this API, otherwise an error will be returned.