Function mentat_ffi::store_begin_transaction

#[no_mangle]
pub unsafe extern "C" fn store_begin_transaction<'a, 'c>(
    store: *mut Store, 
    error: *mut ExternError
) -> *mut InProgress<'a, 'c>

Starts a new transaction to allow multiple transacts to be performed together. This is more efficient than performing a large set of individual commits.

Safety

Callers must ensure that the pointer to the Store is not dangling.

Callers are responsible for managing the memory for the return value. A destructor in_progress_destroy is provided for releasing the memory for this pointer type.

TODO: Document the errors that can result from begin_transaction