struct EBookBackendSummary

struct EBookBackendSummary;

e_book_backend_summary_new ()

EBookBackendSummary* e_book_backend_summary_new         (const gchar *summary_path,
                                                         gint flush_timeout_millis);

Creates an EBookBackendSummary object without loading it or otherwise affecting the file. flush_timeout_millis specifies how much time should elapse, at a minimum, from the summary is changed until it is flushed to disk.

e_book_backend_summary_load ()

gboolean            e_book_backend_summary_load         (EBookBackendSummary *summary);

Attempts to load summary from disk. The load is successful if the file was located, it was in the correct format, and it was not out of date.

e_book_backend_summary_save ()

gboolean            e_book_backend_summary_save         (EBookBackendSummary *summary);

Attempts to save summary to disk.

e_book_backend_summary_add_contact ()

void                e_book_backend_summary_add_contact  (EBookBackendSummary *summary,
                                                         EContact *contact);

Adds a summary of contact to summary. Does not check if the contact already has a summary.

e_book_backend_summary_remove_contact ()

void                e_book_backend_summary_remove_contact
                                                        (EBookBackendSummary *summary,
                                                         const gchar *id);

Removes the summary of the contact identified by id from summary.

e_book_backend_summary_check_contact ()

gboolean            e_book_backend_summary_check_contact
                                                        (EBookBackendSummary *summary,
                                                         const gchar *id);

Checks if a summary of the contact identified by id exists in summary.

e_book_backend_summary_touch ()

void                e_book_backend_summary_touch        (EBookBackendSummary *summary);

Indicates that summary has changed and should be flushed to disk.

e_book_backend_summary_is_up_to_date ()

gboolean            e_book_backend_summary_is_up_to_date
                                                        (EBookBackendSummary *summary,
                                                         time_t t);

Checks if summary is more recent than t.

e_book_backend_summary_is_summary_query ()

gboolean            e_book_backend_summary_is_summary_query
                                                        (EBookBackendSummary *summary,
                                                         const gchar *query);

Checks if query can be satisfied by searching only the fields stored by summary.

e_book_backend_summary_search ()

GPtrArray*          e_book_backend_summary_search       (EBookBackendSummary *summary,
                                                         const gchar *query);

Searches summary for contacts matching query.

e_book_backend_summary_get_summary_vcard ()

gchar *             e_book_backend_summary_get_summary_vcard
                                                        (EBookBackendSummary *summary,
                                                         const gchar *id);

Constructs and returns a VCard from the contact summary specified by id.