From 00c60fbcb3b2b7c9f90c36e4dfb9393fdf678735 Mon Sep 17 00:00:00 2001 From: Jani Nikula Date: Tue, 15 Nov 2011 22:08:48 +0200 Subject: lib: add function to get the number of threads matching a search Add function notmuch_query_count_threads() to get the number of threads matching a search. This is done by performing a search and figuring out the number of unique thread IDs in the matching messages, a significantly heavier operation than notmuch_query_count_messages(). Signed-off-by: Jani Nikula --- lib/notmuch.h | 14 ++++++++++++++ 1 file changed, 14 insertions(+) (limited to 'lib/notmuch.h') diff --git a/lib/notmuch.h b/lib/notmuch.h index c4330e4b..9f23a106 100644 --- a/lib/notmuch.h +++ b/lib/notmuch.h @@ -609,6 +609,20 @@ notmuch_threads_destroy (notmuch_threads_t *threads); unsigned notmuch_query_count_messages (notmuch_query_t *query); +/* 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(). + * + * If an error occurs, this function may return 0. + */ +unsigned +notmuch_query_count_threads (notmuch_query_t *query); + /* Get the thread ID of 'thread'. * * The returned string belongs to 'thread' and as such, should not be -- cgit v1.2.3