Mercurial > dovecot > core-2.2

changeset 12574:c1e71f579adc

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
lib-storage: Added warning comments about mail_get_*header*utf8().
author Timo Sirainen <tss@iki.fi>
date Sat, 01 Jan 2011 14:34:14 +0200
parents 6813e76eb29e
children c39557b7662d 384d8615039f
files src/lib-storage/mail-storage.h
diffstat 1 files changed, 7 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/src/lib-storage/mail-storage.h	Sat Jan 01 13:27:16 2011 +0200
+++ b/src/lib-storage/mail-storage.h	Sat Jan 01 14:34:14 2011 +0200
@@ -642,7 +642,11 @@
 int mail_get_first_header(struct mail *mail, const char *field,
 			  const char **value_r);
 /* Like mail_get_first_header(), but decode MIME encoded words to UTF-8.
-   Also multiline headers are returned unfolded. */
+   Also multiline headers are returned unfolded.
+
+   Do not use this function for getting structured fields (e.g. address fields),
+   because decoding may break the structuring. Instead parse them first and
+   only afterwards decode the encoded words. */
 int mail_get_first_header_utf8(struct mail *mail, const char *field,
 			       const char **value_r);
 /* Return a NULL-terminated list of values for each found field.
@@ -650,7 +654,8 @@
 int mail_get_headers(struct mail *mail, const char *field,
 		     const char *const **value_r);
 /* Like mail_get_headers(), but decode MIME encoded words to UTF-8.
-   Also multiline headers are returned unfolded. */
+   Also multiline headers are returned unfolded.
+   Do not use for structured fields (see mail_get_first_header_utf8()). */
 int mail_get_headers_utf8(struct mail *mail, const char *field,
 			  const char *const **value_r);
 /* Returns stream containing specified headers. */