Top | ![]() |
![]() |
![]() |
![]() |
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.
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.
gboolean
e_book_backend_summary_save (EBookBackendSummary *summary
);
Attempts to save summary
to disk.
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.
void e_book_backend_summary_remove_contact (EBookBackendSummary *summary
,const gchar *id
);
Removes the summary of the contact identified by id
from summary
.
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
.
void
e_book_backend_summary_touch (EBookBackendSummary *summary
);
Indicates that summary
has changed and should be flushed to disk.
gboolean e_book_backend_summary_is_up_to_date (EBookBackendSummary *summary
,time_t t
);
Checks if summary
is more recent than t
.
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
.
GPtrArray * e_book_backend_summary_search (EBookBackendSummary *summary
,const gchar *query
);
Searches summary
for contacts matching query
.
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
.