Mercurial > dovecot > original-hg > dovecot-1.2
view src/lib-storage/mail-search.h @ 7908:1e69c84a1e5a HEAD
Search code cleanups and minor optimizations.
author | Timo Sirainen <tss@iki.fi> |
---|---|
date | Fri, 20 Jun 2008 05:35:05 +0300 |
parents | ec49260ed4ee |
children | bf9c51edbc66 |
line wrap: on
line source
#ifndef MAIL_SEARCH_H #define MAIL_SEARCH_H #include "seq-range-array.h" #include "mail-types.h" enum mail_search_arg_type { SEARCH_OR, SEARCH_SUB, /* sequence sets */ SEARCH_ALL, SEARCH_SEQSET, SEARCH_UIDSET, /* flags */ SEARCH_FLAGS, SEARCH_KEYWORDS, /* dates */ SEARCH_BEFORE, SEARCH_ON, /* time must point to beginning of the day */ SEARCH_SINCE, SEARCH_SENTBEFORE, SEARCH_SENTON, /* time must point to beginning of the day */ SEARCH_SENTSINCE, /* sizes */ SEARCH_SMALLER, SEARCH_LARGER, /* headers */ SEARCH_HEADER, SEARCH_HEADER_ADDRESS, SEARCH_HEADER_COMPRESS_LWSP, /* body */ SEARCH_BODY, SEARCH_TEXT, SEARCH_BODY_FAST, SEARCH_TEXT_FAST, /* extensions */ SEARCH_MODSEQ }; enum mail_search_arg_flag { /* For (SENT)BEFORE/SINCE/ON searches: Don't drop timezone from comparisons */ MAIL_SEARCH_ARG_FLAG_USE_TZ = 0x01, }; enum mail_search_modseq_type { MAIL_SEARCH_MODSEQ_TYPE_ANY = 0, MAIL_SEARCH_MODSEQ_TYPE_PRIVATE, MAIL_SEARCH_MODSEQ_TYPE_SHARED }; struct mail_search_modseq { uint64_t modseq; enum mail_search_modseq_type type; }; struct mail_search_arg { struct mail_search_arg *next; enum mail_search_arg_type type; struct { struct mail_search_arg *subargs; ARRAY_TYPE(seq_range) seqset; const char *str; time_t time; uoff_t size; enum mail_flags flags; struct mail_keywords *keywords; struct mail_search_modseq *modseq; enum mail_search_arg_flag search_flags; } value; void *context; const char *hdr_field_name; /* for SEARCH_HEADER* */ unsigned int not:1; unsigned int match_always:1; /* result = 1 always */ int result; /* -1 = unknown, 0 = unmatched, 1 = matched */ }; struct mail_search_args { int refcount; pool_t pool; struct mailbox *box; struct mail_search_arg *args; const char *charset; unsigned int initialized:1; unsigned int simplified:1; unsigned int have_inthreads:1; }; #define ARG_SET_RESULT(arg, res) \ STMT_START { \ (arg)->result = !(arg)->not ? (res) : \ (res) == -1 ? -1 : !(res); \ } STMT_END typedef void mail_search_foreach_callback_t(struct mail_search_arg *arg, void *context); /* Allocate keywords for search arguments. If change_uidsets is TRUE, change uidsets to seqsets. */ void mail_search_args_init(struct mail_search_args *args, struct mailbox *box, bool change_uidsets, const ARRAY_TYPE(seq_range) *search_saved_uidset); /* Free keywords. The args can initialized afterwards again if needed. */ void mail_search_args_deinit(struct mail_search_args *args); /* Convert sequence sets in args to UIDs. */ void mail_search_args_seq2uid(struct mail_search_args *args); void mail_search_args_ref(struct mail_search_args *args); void mail_search_args_unref(struct mail_search_args **args); /* Reset the results in search arguments. match_always is reset only if full_reset is TRUE. */ void mail_search_args_reset(struct mail_search_arg *args, bool full_reset); /* goes through arguments in list that don't have a result yet. Returns 1 = search matched, 0 = search unmatched, -1 = don't know yet */ int mail_search_args_foreach(struct mail_search_arg *args, mail_search_foreach_callback_t *callback, void *context); #ifdef CONTEXT_TYPE_SAFETY # define mail_search_args_foreach(args, callback, context) \ ({(void)(1 ? 0 : callback((struct mail_search_arg *)NULL, context)); \ mail_search_args_foreach(args, \ (mail_search_foreach_callback_t *)callback, context); }) #else # define mail_search_args_foreach(args, callback, context) \ mail_search_args_foreach(args, \ (mail_search_foreach_callback_t *)callback, context) #endif /* Fills have_headers and have_body based on if such search argument exists that needs to be checked. Returns the headers that we're searching for, or NULL if we're searching for TEXT. */ const char *const * mail_search_args_analyze(struct mail_search_arg *args, bool *have_headers, bool *have_body); /* Simplify/optimize search arguments */ void mail_search_args_simplify(struct mail_search_args *args); #endif