X-Git-Url: https://git.notmuchmail.org/git?a=blobdiff_plain;f=lib%2Fnotmuch.h;h=9f23a106e53b7acef19d1bf26036ed6993a361df;hb=66ecd9063f041329d50f6ca2f9260e3b724eb868;hp=c4330e4b3e620119b22790ba9a24163aac7bdf4f;hpb=520c9c3131b84e30e0d31084a94c55c265f2042f;p=notmuch

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