e_timezone_cache_add_timezone ()

void
e_timezone_cache_add_timezone (ETimezoneCache *cache,
                               icaltimezone *zone);

Adds a copy of zone to cache and emits a “timezone-added” signal. The cache will use the TZID string returned by icaltimezone_get_tzid() as the lookup key, which can be passed to e_timezone_cache_get_timezone() to obtain zone again.

If the cache already has an icaltimezone with the same TZID string as zone , the cache will remain unchanged to avoid invalidating any icaltimezone pointers which may have already been returned through e_timezone_cache_get_timezone().

Since: 3.8

e_timezone_cache_get_timezone ()

icaltimezone *
e_timezone_cache_get_timezone (ETimezoneCache *cache,
                               const gchar *tzid);

Obtains an icaltimezone by its TZID string. If no match is found, the function returns NULL. The returned icaltimezone is owned by the cache and should not be modified or freed.

Since: 3.8

e_timezone_cache_list_timezones ()

GList *
e_timezone_cache_list_timezones (ETimezoneCache *cache);

Returns a list of icaltimezone instances that were explicitly added to the cache through e_timezone_cache_add_timezone(). In particular, any built-in time zone data that e_timezone_cache_get_timezone() may use to match a TZID string is excluded from the returned list.

Free the returned list with g_list_free(). The list elements are owned by the cache and should not be modified or freed.

Since: 3.8

struct ETimezoneCacheInterface

struct ETimezoneCacheInterface {
	GTypeInterface parent_interface;

	/* Methods */
	void		(*add_timezone)		(ETimezoneCache *cache,
						 icaltimezone *zone);
	icaltimezone * (*get_timezone)		(ETimezoneCache *cache,
						 const gchar *tzid);
	GList *		(*list_timezones) (ETimezoneCache *cache);

	/* Signals */
	void		(*timezone_added) (ETimezoneCache *cache,
						 icaltimezone *zone);
};

Since: 3.8

ETimezoneCache

typedef struct _ETimezoneCache ETimezoneCache;

Since: 3.8