Small. Fast. Reliable.
Choose any three.

SQLite Requirement Matrix Details
get_auxdata.html

Index Summary Markup Original


R-60354-20889-08595-48824-21285-36723-22073-47056 tcl slt th3 src

The sqlite3_get_auxdata(C,N) interface returns a pointer to the metadata associated by the sqlite3_set_auxdata(C,N,P,X) function with the Nth argument value to the application-defined function.

/* IMP: R-60354-20889 */
# EVIDENCE-OF: R-60354-20889 The sqlite3_get_auxdata(C,N) interface
# returns a pointer to the metadata associated by the
# sqlite3_set_auxdata(C,N,P,X) function with the Nth argument value to
# the application-defined function.

R-52799-16320-39840-10926-00511-08842-62770-55110 tcl slt th3 src

N is zero for the left-most function argument.

/* IMP: R-52799-16320 */
# EVIDENCE-OF: R-52799-16320 N is zero for the left-most function
# argument.

R-18031-23188-38756-14350-07582-34544-63211-44348 tcl slt th3 src

If there is no metadata associated with the function argument, the sqlite3_get_auxdata(C,N) interface returns a NULL pointer.

/* IMP: R-18031-23188 */
# EVIDENCE-OF: R-18031-23188 If there is no metadata associated with the
# function argument, the sqlite3_get_auxdata(C,N) interface returns a
# NULL pointer.

R-27542-08072-33902-06053-42391-63696-60417-63522 tcl slt th3 src

The sqlite3_set_auxdata(C,N,P,X) interface saves P as metadata for the N-th argument of the application-defined function.

/* IMP: R-27542-08072 */
# EVIDENCE-OF: R-27542-08072 The sqlite3_set_auxdata(C,N,P,X) interface
# saves P as metadata for the N-th argument of the application-defined
# function.

R-32857-15826-08814-08217-40160-38064-19925-14488 tcl slt th3 src

Subsequent calls to sqlite3_get_auxdata(C,N) return P from the most recent sqlite3_set_auxdata(C,N,P,X) call if the metadata is still valid or NULL if the metadata has been discarded.

/* IMP: R-32857-15826 */
# EVIDENCE-OF: R-32857-15826 Subsequent calls to
# sqlite3_get_auxdata(C,N) return P from the most recent
# sqlite3_set_auxdata(C,N,P,X) call if the metadata is still valid or
# NULL if the metadata has been discarded.

R-49931-19798-23474-09370-36216-10511-05923-60825 tcl slt th3 src

After each call to sqlite3_set_auxdata(C,N,P,X) where X is not NULL, SQLite will invoke the destructor function X with parameter P exactly once, when the metadata is discarded.

/* IMP: R-49931-19798 */
# EVIDENCE-OF: R-49931-19798 After each call to
# sqlite3_set_auxdata(C,N,P,X) where X is not NULL, SQLite will invoke
# the destructor function X with parameter P exactly once, when the
# metadata is discarded.

R-45087-11455-34010-58446-15384-63423-21176-52177 tcl slt th3 src

when the corresponding function parameter changes

/* IMP: R-45087-11455 */
# EVIDENCE-OF: R-45087-11455 when the corresponding function parameter
# changes

R-43881-23456-20563-20957-51474-28716-20128-57454 tcl slt th3 src

when sqlite3_reset() or sqlite3_finalize() is called for the SQL statement

/* IMP: R-43881-23456 */
# EVIDENCE-OF: R-43881-23456 when sqlite3_reset() or sqlite3_finalize()
# is called for the SQL statement

R-38493-22774-30789-51088-59525-02333-30794-32184 tcl slt th3 src

when sqlite3_set_auxdata() is invoked again on the same parameter

/* IMP: R-38493-22774 */
# EVIDENCE-OF: R-38493-22774 when sqlite3_set_auxdata() is invoked again
# on the same parameter

R-31929-21448-54248-05455-38618-31976-59904-18809 tcl slt th3 src

during the original sqlite3_set_auxdata() call when a memory allocation error occurs.

/* IMP: R-31929-21448 */
# EVIDENCE-OF: R-31929-21448 during the original sqlite3_set_auxdata()
# call when a memory allocation error occurs.

R-22304-13691-20726-05433-26877-46116-43863-25024 tcl slt th3 src

In practice, metadata is preserved between function calls for function parameters that are compile-time constants, including literal values and parameters and expressions composed from the same.

/* IMP: R-22304-13691 */
# EVIDENCE-OF: R-22304-13691 In practice, metadata is preserved between
# function calls for function parameters that are compile-time
# constants, including literal values and parameters and expressions
# composed from the same.