diff options
| author | Daniel Kahn Gillmor <dkg@fifthhorseman.net> | 2018-05-11 02:57:53 -0400 |
|---|---|---|
| committer | David Bremner <david@tethera.net> | 2018-05-26 07:31:39 -0700 |
| commit | 499bb78178df86ceae82893fbc272c4dd1870b6c (patch) | |
| tree | 5b7100f2a214025b6d60844a3cdb368346df4309 /lib/notmuch.h | |
| parent | 4a6371f1d80aec5947b41d7c4e1fdb60cca3c55d (diff) | |
properties: add notmuch_message_count_properties
The user can already do this manually, of course, but (a) it's nice to
have a convenience function, and (b) exposing this interface means
that someone more clever with a _notmuch_string_map_t than i am can
write a more efficient version if they like, and it will just
accelerate the users of the convenience function.
Diffstat (limited to 'lib/notmuch.h')
| -rw-r--r-- | lib/notmuch.h | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/lib/notmuch.h b/lib/notmuch.h index 216b1c75..a8981c5c 100644 --- a/lib/notmuch.h +++ b/lib/notmuch.h @@ -1891,6 +1891,22 @@ notmuch_message_properties_t * notmuch_message_get_properties (notmuch_message_t *message, const char *key, notmuch_bool_t exact); /** + * Return the number of properties named "key" belonging to the specific message. + * + * @param[in] message The message to examine + * @param[in] key key to count + * @param[out] count The number of matching properties associated with this message. + * + * @returns + * + * NOTMUCH_STATUS_SUCCESS: successful count, possibly some other error. + * + * @since libnotmuch 5.2 (notmuch 0.27) + */ +notmuch_status_t +notmuch_message_count_properties (notmuch_message_t *message, const char *key, unsigned int *count); + +/** * Is the given *properties* iterator pointing at a valid (key,value) * pair. * |