X-Git-Url: https://git.notmuchmail.org/git?a=blobdiff_plain;f=lib%2Fnotmuch.h;h=3e326bfc4da9a1ef844033878566b3e1bc509c28;hb=fd80a9cac1b773d50acef42522ef767c1a2d44b7;hp=92594b9dad9e4110e41ca29ef82266d6be821426;hpb=bc9c50602d20ce712188ea2cc3c5d30647d4d3f5;p=notmuch diff --git a/lib/notmuch.h b/lib/notmuch.h index 92594b9d..3e326bfc 100644 --- a/lib/notmuch.h +++ b/lib/notmuch.h @@ -55,7 +55,7 @@ NOTMUCH_BEGIN_DECLS * The library version number. This must agree with the soname * version in Makefile.local. */ -#define LIBNOTMUCH_MAJOR_VERSION 3 +#define LIBNOTMUCH_MAJOR_VERSION 4 #define LIBNOTMUCH_MINOR_VERSION 1 #define LIBNOTMUCH_MICRO_VERSION 0 @@ -780,10 +780,18 @@ notmuch_query_add_tag_exclude (notmuch_query_t *query, const char *tag); * to call it if the query is about to be destroyed). * * If a Xapian exception occurs this function will return NULL. + * For better error reporting, use the _st variant. */ notmuch_threads_t * notmuch_query_search_threads (notmuch_query_t *query); +/** + * Like notmuch_query_search_threads, but with a status return. + */ +notmuch_status_t +notmuch_query_search_threads_st (notmuch_query_t *query, + notmuch_threads_t **out); + /** * Execute a query for messages, returning a notmuch_messages_t object * which can be used to iterate over the results. The returned @@ -822,10 +830,18 @@ notmuch_query_search_threads (notmuch_query_t *query); * reason to call it if the query is about to be destroyed). * * If a Xapian exception occurs this function will return NULL. + * For better error reporting, use the _st variant. */ notmuch_messages_t * notmuch_query_search_messages (notmuch_query_t *query); +/** + * Like notmuch_query_search_messages, but with a status return. + */ +notmuch_status_t +notmuch_query_search_messages_st (notmuch_query_t *query, + notmuch_messages_t **out); + /** * Destroy a notmuch_query_t along with any associated resources. *