diff options
author | Austin Clements <amdragon@MIT.EDU> | 2013-01-06 15:22:39 -0500 |
---|---|---|
committer | David Bremner <bremner@debian.org> | 2013-01-06 22:39:51 -0400 |
commit | 7c3a995d6b6e066aa68b0adf0433f45cb3812c2a (patch) | |
tree | 9404dc39fe263723f0ec15ed3497b10bb38e105b /util/string-util.h | |
parent | 25cf5f5dc45cac42f15643f6df09b46d51d7b5ec (diff) |
util: Function to parse boolean term queries
This parses the subset of Xapian's boolean term quoting rules that are
used by make_boolean_term. This is provided as a generic string
utility, but will be used shortly in notmuch restore to parse and
optimize for ID queries.
Diffstat (limited to 'util/string-util.h')
-rw-r--r-- | util/string-util.h | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/util/string-util.h b/util/string-util.h index 719c276a..0194607e 100644 --- a/util/string-util.h +++ b/util/string-util.h @@ -34,4 +34,20 @@ char *strtok_len (char *s, const char *delim, size_t *len); int make_boolean_term (void *talloc_ctx, const char *prefix, const char *term, char **buf, size_t *len); +/* Parse a boolean term query consisting of a prefix, a colon, and a + * term that may be quoted as described for make_boolean_term. If the + * term is not quoted, then it ends at the first whitespace or close + * parenthesis. str may containing leading or trailing whitespace, + * but anything else is considered a parse error. This is compatible + * with anything produced by make_boolean_term, and supports a subset + * of the quoting styles supported by Xapian (and hence notmuch). + * *prefix_out and *term_out will be talloc'd with context ctx. + * + * Return: 0 on success, -1 on error. errno will be set to EINVAL if + * there is a parse error or ENOMEM if there is an allocation failure. + */ +int +parse_boolean_term (void *ctx, const char *str, + char **prefix_out, char **term_out); + #endif |