![]() |
![]() |
![]() |
Evolution API Reference: libedata-book, the Addressbook backend library | ![]() |
---|---|---|---|---|
EContact* e_book_backend_db_cache_get_contact (DB *db, const char *uid); void string_to_dbt (const char *str, DBT *dbt); char* e_book_backend_db_cache_get_filename (DB *db); void e_book_backend_db_cache_set_filename (DB *db, const char *filename); gboolean e_book_backend_db_cache_add_contact (DB *db, EContact *contact); gboolean e_book_backend_db_cache_remove_contact (DB *db, const char *uid); gboolean e_book_backend_db_cache_check_contact (DB *db, const char *uid); GList* e_book_backend_db_cache_get_contacts (DB *db, const char *query); gboolean e_book_backend_db_cache_exists (const char *uri); void e_book_backend_db_cache_set_populated (DB *db); gboolean e_book_backend_db_cache_is_populated (DB *db); GPtrArray* e_book_backend_db_cache_search (DB *db, const char *query);
EContact* e_book_backend_db_cache_get_contact (DB *db, const char *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.
char* e_book_backend_db_cache_get_filename (DB *db);
Get the filename for db cacahe file.
db : |
DB Handle |
Returns : |
void e_book_backend_db_cache_set_filename (DB *db, const char *filename);
Set the filename for db cacahe file.
db : |
DB Handle |
filename : |
filename to be set |
gboolean e_book_backend_db_cache_add_contact (DB *db, EContact *contact);
Adds contact
to cache
.
gboolean e_book_backend_db_cache_remove_contact (DB *db, const char *uid);
Removes the contact identified by uid
from cache
.
gboolean e_book_backend_db_cache_check_contact (DB *db, const char *uid);
Checks if the contact identified by uid
exists in cache
.
GList* e_book_backend_db_cache_get_contacts (DB *db, const char *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.
gboolean e_book_backend_db_cache_exists (const char *uri);
Checks if an EBookBackendCache exists at uri
.
void e_book_backend_db_cache_set_populated (DB *db);
Flags cache
as being populated - that is, it is up-to-date on the
contents of the book it's caching.
db : |
gboolean e_book_backend_db_cache_is_populated (DB *db);
db : |
|
Returns : |
GPtrArray* e_book_backend_db_cache_search (DB *db, const char *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.
db : |
|
query : |
an s-expression |
Returns : | A GPtrArray of pointers to contact ID strings. |