#include <time.h>
#include <glib.h>
+#define _FM(str) dgettext("hildon-fm",str)
+
/**
* modest_text_utils_derived_subject:
* @subject: a string which contains the original subject
* ie. removes "<...>" and "(...)" parts
* the change is in-place; removes leading/trailing whitespace
*
- * Returns: the new address. The string is *not* newly allocated.
- * NULL in case of error
+ * Returns: the new address of the string; this new string
+ * is _NOT_ newly allocated, so should not be freed. (remember
+ * the old address of the parameter if that one needs to be freed)
+ *
+ * NULL in case of error or if address == NULL
*/
gchar* modest_text_utils_get_display_address (gchar *address);
* Returns: the newly allocated display string for the
* size in bytes. must be freed.
*/
-gchar * modest_text_utils_get_display_size (guint size);
+gchar * modest_text_utils_get_display_size (guint64 size);
/**
gboolean modest_text_utils_validate_email_address (const gchar *email_address);
/**
+ * modest_text_utils_validate_recipient:
+ * @recipient: a string
+ *
+ * validates @recipient as a valid recipient field for header.
+ * It's different from modest_text_utils_validate_email_address()
+ * as it validates a whole recipient, and not only the part between
+ * the < and > symbols.
+ *
+ * Returns: %TRUE if the recipient is valid, FALSE otherwise
+ **/
+gboolean modest_text_utils_validate_recipient (const gchar *recipient);
+
+/**
* modest_text_utils_split_addresses_list:
* @addresses: a string
*
**/
GSList *modest_text_utils_split_addresses_list (const gchar *addresses);
+/**
+ * modest_text_utils_get_addresses_indexes:
+ * @addresses: a string
+ * @start_indexes: a #GSList pointer
+ * @end_indexes: a #GSList pointer
+ *
+ * obtains two #GSList of @addresses with the range offsets of the addresses in
+ * the string
+ *
+ * Returns: a GSList of strings
+ **/
+void modest_text_utils_get_addresses_indexes (const gchar *addresses, GSList **start_indexes, GSList **end_indexes);
+
#endif /* __MODEST_TEXT_UTILS_H__ */