Merge branch 'release'
[notmuch] / lib / database-private.h
1 /* database-private.h - For peeking into the internals of notmuch_database_t
2  *
3  * Copyright © 2009 Carl Worth
4  *
5  * This program is free software: you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License as published by
7  * the Free Software Foundation, either version 3 of the License, or
8  * (at your option) any later version.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program.  If not, see http://www.gnu.org/licenses/ .
17  *
18  * Author: Carl Worth <cworth@cworth.org>
19  */
20
21 #ifndef NOTMUCH_DATABASE_PRIVATE_H
22 #define NOTMUCH_DATABASE_PRIVATE_H
23
24 /* According to WG14/N1124, a C++ implementation won't provide us a
25  * macro like PRIx64 (which gives a printf format string for
26  * formatting a uint64_t as hexadecimal) unless we define
27  * __STDC_FORMAT_MACROS before including inttypes.h. That's annoying,
28  * but there it is.
29  */
30 #define __STDC_FORMAT_MACROS
31 #include <inttypes.h>
32
33 #include "notmuch-private.h"
34
35 #include <xapian.h>
36
37 #pragma GCC visibility push(hidden)
38
39 struct _notmuch_database {
40     notmuch_bool_t exception_reported;
41
42     char *path;
43
44     notmuch_bool_t needs_upgrade;
45     notmuch_database_mode_t mode;
46     int atomic_nesting;
47     Xapian::Database *xapian_db;
48
49     unsigned int last_doc_id;
50     uint64_t last_thread_id;
51
52     Xapian::QueryParser *query_parser;
53     Xapian::TermGenerator *term_gen;
54     Xapian::ValueRangeProcessor *value_range_processor;
55 };
56
57 /* Return the list of terms from the given iterator matching a prefix.
58  * The prefix will be stripped from the strings in the returned list.
59  * The list will be allocated using ctx as the talloc context.
60  *
61  * The function returns NULL on failure.
62  */
63 notmuch_string_list_t *
64 _notmuch_database_get_terms_with_prefix (void *ctx, Xapian::TermIterator &i,
65                                          Xapian::TermIterator &end,
66                                          const char *prefix);
67
68 #pragma GCC visibility pop
69
70 #endif