Function notmuch_sys::notmuch_query_count_threads_st [] [src]

pub unsafe extern "C" fn notmuch_query_count_threads_st(
    query: *mut notmuch_query_t,
    count: *mut c_uint
) -> notmuch_status_t

Return the number of threads matching a search.

This function performs a search and returns the number of unique thread IDs in the matching messages. This is the same as number of threads matching a search.

Note that this is a significantly heavier operation than notmuch_query_count_messages{_st}().

@returns

  • notmuch_status_t::OUT_OF_MEMORY: Memory allocation failed. The value of *count is not defined
  • notmuch_status_t::SUCCESS: query completed successfully.

  • notmuch_status_t::XAPIAN_EXCEPTION: a Xapian exception occured. The value of *count is not defined.

@since libnotmuch 4.3 (notmuch 0.21)