struct EBookBackendCache

struct EBookBackendCache;

e_book_backend_cache_new ()

EBookBackendCache * e_book_backend_cache_new            (const gchar *filename);

Creates a new EBookBackendCache, which implements a local cache of EContact objects, useful for remote backends.

e_book_backend_cache_get_contact ()

EContact *          e_book_backend_cache_get_contact    (EBookBackendCache *cache,
                                                         const gchar *uid);

Get a cached contact. Note that the returned EContact will be newly created, and must be unreffed by the caller when no longer needed.

e_book_backend_cache_add_contact ()

gboolean            e_book_backend_cache_add_contact    (EBookBackendCache *cache,
                                                         EContact *contact);

Adds contact to cache.

e_book_backend_cache_remove_contact ()

gboolean            e_book_backend_cache_remove_contact (EBookBackendCache *cache,
                                                         const gchar *uid);

Removes the contact identified by uid from cache.

e_book_backend_cache_check_contact ()

gboolean            e_book_backend_cache_check_contact  (EBookBackendCache *cache,
                                                         const gchar *uid);

Checks if the contact identified by uid exists in cache.

e_book_backend_cache_get_contacts ()

GList *             e_book_backend_cache_get_contacts   (EBookBackendCache *cache,
                                                         const gchar *query);

Returns a list of EContact elements from cache matching query. When done with the list, the caller must unref the contacts and free the list.

e_book_backend_cache_set_populated ()

void                e_book_backend_cache_set_populated  (EBookBackendCache *cache);

Flags cache as being populated - that is, it is up-to-date on the contents of the book it's caching.

e_book_backend_cache_is_populated ()

gboolean            e_book_backend_cache_is_populated   (EBookBackendCache *cache);

Checks if cache is populated.

e_book_backend_cache_set_time ()

void                e_book_backend_cache_set_time       (EBookBackendCache *cache,
                                                         const gchar *t);

e_book_backend_cache_get_time ()

gchar *             e_book_backend_cache_get_time       (EBookBackendCache *cache);

e_book_backend_cache_search ()

GPtrArray *         e_book_backend_cache_search         (EBookBackendCache *cache,
                                                         const gchar *query);

Returns an array of pointers to unique contact ID strings for contacts in cache matching query. When done with the array, the caller must free the ID strings and the array.