e_get_user_cache_dir ()

const gchar *
e_get_user_cache_dir (void);

Returns a base directory in which to store user-specific, non-essential cached data for Evolution or Evolution-Data-Server.

The returned string is owned by libedataserver and must not be modified or freed.

Since 2.32

e_get_user_config_dir ()

const gchar *
e_get_user_config_dir (void);

Returns a base directory in which to store user-specific configuration information for Evolution or Evolution-Data-Server.

The returned string is owned by libedataserver and must not be modified or freed.

Since 2.32

e_get_user_data_dir ()

const gchar *
e_get_user_data_dir (void);

Returns a base directory in which to store user-specific data for Evolution or Evolution-Data-Server.

The returned string is owned by libedataserver and must not be modified or freed.

Since 2.32

e_util_strstrcase ()

gchar *
e_util_strstrcase (const gchar *haystack,
                   const gchar *needle);

Find the first instance of needle in haystack , ignoring case for bytes that are ASCII characters.

e_util_unicode_get_utf8 ()

gchar *
e_util_unicode_get_utf8 (const gchar *text,
                         gunichar *out);

Get a UTF-8 character from the beginning of text .

e_util_utf8_strstrcase ()

const gchar *
e_util_utf8_strstrcase (const gchar *haystack,
                        const gchar *needle);

Find the first instance of needle in haystack , ignoring case. (No proper case folding or decomposing is done.) Both needle and haystack are UTF-8 strings.

e_util_utf8_strstrcasedecomp ()

const gchar *
e_util_utf8_strstrcasedecomp (const gchar *haystack,
                              const gchar *needle);

Find the first instance of needle in haystack , where both needle and haystack are UTF-8 strings. Both strings are stripped and decomposed for comparison, and case is ignored.

e_util_utf8_strcasecmp ()

gint
e_util_utf8_strcasecmp (const gchar *s1,
                        const gchar *s2);

Compares two UTF-8 strings using approximate case-insensitive ordering.

e_util_utf8_remove_accents ()

gchar *
e_util_utf8_remove_accents (const gchar *str);

Returns a newly-allocated copy of str with accents removed.

Since 2.28

e_util_utf8_make_valid ()

gchar *
e_util_utf8_make_valid (const gchar *str);

Returns a newly-allocated copy of str , with invalid characters replaced by Unicode replacement characters (U+FFFD).

Since 3.0

e_util_ensure_gdbus_string ()

const gchar *
e_util_ensure_gdbus_string (const gchar *str,
                            gchar **gdbus_str);

If str is a valid UTF-8 string, the function returns str and does not set gdbus_str .

If str is an invalid UTF-8 string, the function calls e_util_utf8_make_valid() and points gdbus_str to the newly-allocated, valid UTF-8 string, and also returns it. The caller should free the string pointed to by gdbus_str with g_free().

If str is NULL, the function returns an empty string and does not set gdbus_str .

Admittedly, the function semantics are a little awkward. The example below illustrates the easiest way to cope with the gdbus_str argument:

<informalexample> <programlisting> const gchar *trusted_utf8; gchar *allocated = NULL;

trusted_utf8 = e_util_ensure_gdbus_string (untrusted_utf8, &allocated);

Do stuff with trusted_utf8, then clear it.

trusted_utf8 = NULL;

g_free (allocated); allocated = NULL; </programlisting> </informalexample>

Since 3.0

e_util_gthread_id ()

guint64
e_util_gthread_id (GThread *thread);

Returns a 64-bit integer hopefully uniquely identifying the thread. To be used in debugging output and logging only. The returned value is just a cast of a pointer to the 64-bit integer.

There is no guarantee that calling e_util_gthread_id() on one thread first and later after that thread has dies on another won't return the same integer.

On Linux and Win32, known to really return a unique id for each thread existing at a certain time. No guarantee that ids won't be reused after a thread has terminated, though.

Since 2.32

e_filename_make_safe ()

void
e_filename_make_safe (gchar *string);

e_filename_mkdir_encoded ()

gchar *
e_filename_mkdir_encoded (const gchar *basepath,
                          const gchar *fileprefix,
                          const gchar *filename,
                          gint fileindex);

Creates a local path constructed from basepath / fileprefix + "-" + filename , and makes sure the path basepath exists. If creation of the path fails, then NULL is returned.

Since 3.4

e_utf8_strftime ()

gsize
e_utf8_strftime (gchar *string,
                 gsize max,
                 const gchar *fmt,
                 const struct tm *tm);

The UTF-8 equivalent of e_strftime().

e_strftime ()

gsize
e_strftime (gchar *string,
            gsize max,
            const gchar *fmt,
            const struct tm *tm);

This function is a wrapper around the strftime (3) function, which converts the %l and %k (12h and 24h) format variables if necessary.

e_util_slist_to_strv ()

gchar **
e_util_slist_to_strv (const GSList *strings);

Convert list of strings into NULL-terminates array of strings.

Since 3.4

e_util_strv_to_slist ()

GSList *
e_util_strv_to_slist (const gchar * const *strv);

Convert NULL-terminated array of strings to a list of strings.

Since 3.4

e_util_copy_string_slist ()

GSList *
e_util_copy_string_slist (GSList *copy_to,
                          const GSList *strings);

Copies GSList of strings at the end of copy_to .

Since 3.4

e_util_copy_object_slist ()

GSList *
e_util_copy_object_slist (GSList *copy_to,
                          const GSList *objects);

Copies GSList of GObject-s at the end of copy_to .

Since 3.4

e_util_free_string_slist ()

void
e_util_free_string_slist (GSList *strings);

Frees memory previously allocated by e_util_strv_to_slist().

Since 3.4

e_util_free_object_slist ()

void
e_util_free_object_slist (GSList *objects);

Calls g_object_unref() on each member of objects and then frees also objects itself.

Since 3.4

e_binding_transform_enum_value_to_nick ()

gboolean
e_binding_transform_enum_value_to_nick
                               (GBinding *binding,
                                const GValue *source_value,
                                GValue *target_value,
                                gpointer not_used);

Transforms an enumeration value to its corresponding nickname.

Since 3.4

e_binding_transform_enum_nick_to_value ()

gboolean
e_binding_transform_enum_nick_to_value
                               (GBinding *binding,
                                const GValue *source_value,
                                GValue *target_value,
                                gpointer not_used);

Transforms an enumeration nickname to its corresponding value.

Since 3.4

e_util_get_prefix ()

const gchar *
e_util_get_prefix (void);

e_util_get_cp_prefix ()

const gchar *
e_util_get_cp_prefix (void);

e_util_get_localedir ()

const gchar *
e_util_get_localedir (void);

e_util_replace_prefix ()

gchar *
e_util_replace_prefix (const gchar *configure_time_prefix,
                       const gchar *runtime_prefix,
                       const gchar *configure_time_path);

e_data_server_util_get_dbus_call_timeout ()

gint
e_data_server_util_get_dbus_call_timeout
                               (void);

Returns the value set by e_data_server_util_set_dbus_call_timeout().

Since 3.0

e_data_server_util_set_dbus_call_timeout ()

void
e_data_server_util_set_dbus_call_timeout
                               (gint timeout_msec);

Sets default timeout, in milliseconds, for calls of g_dbus_proxy_call() family functions.

-1 means the default value as set by D-Bus itself. G_MAXINT means no timeout at all.

Default value is set also by configure option --with-dbus-call-timeout=ms and -1 is used when not set.

Since 3.0

e_pointer_tracker_track()

#define             e_pointer_tracker_track(ptr)

FIXME: Document me.

Since 3.2

e_pointer_tracker_track_with_info ()

void
e_pointer_tracker_track_with_info (gpointer ptr,
                                   const gchar *info);

FIXME: Document me.

Since 3.2

e_pointer_tracker_untrack ()

void
e_pointer_tracker_untrack (gpointer ptr);

FIXME: Document me.

Since 3.2

e_pointer_tracker_dump ()

void
e_pointer_tracker_dump (void);

FIXME: Document me.

Since 3.2

struct tm

struct tm;