stumpless_set_sqlite3_insert_sql

Function stumpless_set_sqlite3_insert_sql 

Source
pub unsafe extern "C" fn stumpless_set_sqlite3_insert_sql(
    target: *mut stumpless_target,
    sql: *const c_char,
) -> *mut stumpless_target
Expand description

Sets the SQL statement used to insert entries into the database.

Thread Safety: MT-Safe This function is thread safe as a mutex is used to coordinate the changes with other target modifications.

Async Signal Safety: AS-Unsafe lock Thisi function is not signal safe, as a non-reentrant lock is used to coordinate the read of the target with other potential accesses.

Async Cancel Safety: AC-Unsafe lock This function is not safe to call from threads that may be asynchronously cancelled, as the cleanup of the lock used for the target may not be completed.

@since release v2.2.0

@param target The target to set the insert SQL for.

@param sql The new SQL insertion statement to use for the target. This string must be valid for the duration of its use in the target, as a pointer to it is kept internally.

@return The modified target on success, or NULL on failure. In the event of failure an error code is set appropriately.