![]() | ![]() | ![]() | Evolution API Reference: libebook, the Addressbook Library | ![]() |
---|
e-book-query — Handles queries of addressboook data.
enum EBookQueryTest;EBookQuery * e_book_query_from_string (constchar *query_string);char * e_book_query_to_string (EBookQuery *q);EBookQuery * e_book_query_ref (EBookQuery *q);void e_book_query_unref (EBookQuery *q);EBookQuery * e_book_query_and (int nqs,EBookQuery **qs,gboolean unref);EBookQuery * e_book_query_andv (EBookQuery *q, ...);EBookQuery * e_book_query_or (int nqs,EBookQuery **qs,gboolean unref);EBookQuery * e_book_query_orv (EBookQuery *q, ...);EBookQuery * e_book_query_not (EBookQuery *q,gboolean unref);EBookQuery * e_book_query_field_exists (EContactField field);EBookQuery * e_book_query_field_test (EContactField field, EBookQueryTest test, constchar *value);EBookQuery * e_book_query_any_field_contains (constchar *value);
typedef enum { E_BOOK_QUERY_IS, E_BOOK_QUERY_CONTAINS, E_BOOK_QUERY_BEGINS_WITH, E_BOOK_QUERY_ENDS_WITH, #if notyet E_BOOK_QUERY_LT, E_BOOK_QUERY_LE, E_BOOK_QUERY_GT, E_BOOK_QUERY_GE, E_BOOK_QUERY_EQ, #endif } EBookQueryTest;
EBookQuery * e_book_query_from_string (constchar *query_string);
Parse query_string and return a new
query_string : | the query |
Returns : | the new |
char * e_book_query_to_string (EBookQuery *q);
Return the string representation of q.
q : | an |
Returns : | The string form of the query. This string should be freed when finished with. |
EBookQuery * e_book_query_ref (EBookQuery *q);
Increment the reference count on q.
q : | a |
Returns : | q |
void e_book_query_unref (EBookQuery *q);
Decrement the reference count on q. When the reference count reaches 0, q will be freed and any child queries will have e_book_query_unref() called.
q : | an |
EBookQuery * e_book_query_and (int nqs,EBookQuery **qs,gboolean unref);
Create a new
nqs : | the number of queries to AND |
qs : | pointer to an array of |
unref : | if |
Returns : | A new |
EBookQuery * e_book_query_andv (EBookQuery *q, ...);
Create a new
q : | first |
... : | |
Returns : | A new |
EBookQuery * e_book_query_or (int nqs,EBookQuery **qs,gboolean unref);
Create a new
nqs : | the number of queries to OR |
qs : | pointer to an array of |
unref : | if |
Returns : | A new |
EBookQuery * e_book_query_orv (EBookQuery *q, ...);
Create a new
q : | first |
... : | |
Returns : | A new |
EBookQuery * e_book_query_not (EBookQuery *q,gboolean unref);
Create a new
q : | an |
unref : | if |
Returns : | the new |
EBookQuery * e_book_query_field_exists (EContactField field);
Create a new
field : | a EContactField |
Returns : | the new |
EBookQuery * e_book_query_field_test (EContactField field, EBookQueryTest test, constchar *value);
Create a new
field : | an EContactField to test |
test : | the test to apply |
value : | the value to test for |
Returns : | the new |
<< EBook | EContact >> |