Function notmuch_sys::notmuch_database_begin_atomic

pub unsafe extern "C" fn notmuch_database_begin_atomic(
    notmuch: *mut notmuch_database_t
) -> notmuch_status_t

Begin an atomic database operation.

Any modifications performed between a successful begin and a notmuch_database_end_atomic will be applied to the database atomically. Note that, unlike a typical database transaction, this only ensures atomicity, not durability; neither begin nor end necessarily flush modifications to disk.

Atomic sections may be nested. begin_atomic and end_atomic must always be called in pairs.

Return value:

• notmuch_status_t::SUCCESS: Successfully entered atomic section.

• notmuch_status_t::XAPIAN_EXCEPTION: A Xapian exception occurred; atomic section not entered.