4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>e-book-query</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.3">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
7
7
<link rel="home" href="index.html" title="Evolution-Data-Server Manual: Address Book Client (libebook)">
8
8
<link rel="up" href="ch01.html" title="Evolution-Data-Server Manual: Address Book Client (libebook)">
9
9
<link rel="prev" href="EBookListener.html" title="EBookListener">
10
10
<link rel="next" href="libebook-e-book-types.html" title="e-book-types">
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.12 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="ch01.html" title="Evolution-Data-Server Manual: Address Book Client (libebook)">
14
14
<link rel="index" href="ix01.html" title="Index">
39
39
</tr></table></div>
40
40
<div class="refsynopsisdiv">
41
41
<a name="libebook-e-book-query.synopsis"></a><h2>Synopsis</h2>
42
<pre class="synopsis">
43
typedef <a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>;
42
<pre class="synopsis">typedef <a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>;
44
43
enum <a class="link" href="libebook-e-book-query.html#EBookQueryTest" title="enum EBookQueryTest">EBookQueryTest</a>;
45
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-from-string" title="e_book_query_from_string ()">e_book_query_from_string</a> (const <a
46
href="../glib/glib-Basic-Types.html#gchar"
47
>gchar</a> *query_string);
49
href="../glib/glib-Basic-Types.html#gchar"
50
>gchar</a> * <a class="link" href="libebook-e-book-query.html#e-book-query-to-string" title="e_book_query_to_string ()">e_book_query_to_string</a> (<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a> *q);
44
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-from-string" title="e_book_query_from_string ()">e_book_query_from_string</a> (const gchar *query_string);
45
gchar * <a class="link" href="libebook-e-book-query.html#e-book-query-to-string" title="e_book_query_to_string ()">e_book_query_to_string</a> (<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a> *q);
51
46
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-ref" title="e_book_query_ref ()">e_book_query_ref</a> (<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a> *q);
52
47
void <a class="link" href="libebook-e-book-query.html#e-book-query-unref" title="e_book_query_unref ()">e_book_query_unref</a> (<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a> *q);
53
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-and" title="e_book_query_and ()">e_book_query_and</a> (<a
54
href="../glib/glib-Basic-Types.html#gint"
48
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-and" title="e_book_query_and ()">e_book_query_and</a> (gint nqs,
56
49
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a> **qs,
58
href="../glib/glib-Basic-Types.html#gboolean"
60
51
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-andv" title="e_book_query_andv ()">e_book_query_andv</a> (<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a> *q,
62
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-or" title="e_book_query_or ()">e_book_query_or</a> (<a
63
href="../glib/glib-Basic-Types.html#gint"
53
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-or" title="e_book_query_or ()">e_book_query_or</a> (gint nqs,
65
54
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a> **qs,
67
href="../glib/glib-Basic-Types.html#gboolean"
69
56
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-orv" title="e_book_query_orv ()">e_book_query_orv</a> (<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a> *q,
71
58
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-not" title="e_book_query_not ()">e_book_query_not</a> (<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a> *q,
73
href="../glib/glib-Basic-Types.html#gboolean"
75
60
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-field-exists" title="e_book_query_field_exists ()">e_book_query_field_exists</a> (<a class="link" href="EContact.html#EContactField" title="enum EContactField">EContactField</a> field);
76
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-vcard-field-exists" title="e_book_query_vcard_field_exists ()">e_book_query_vcard_field_exists</a> (const <a
77
href="../glib/glib-Basic-Types.html#gchar"
61
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-vcard-field-exists" title="e_book_query_vcard_field_exists ()">e_book_query_vcard_field_exists</a> (const gchar *field);
79
62
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-field-test" title="e_book_query_field_test ()">e_book_query_field_test</a> (<a class="link" href="EContact.html#EContactField" title="enum EContactField">EContactField</a> field,
80
63
<a class="link" href="libebook-e-book-query.html#EBookQueryTest" title="enum EBookQueryTest">EBookQueryTest</a> test,
82
href="../glib/glib-Basic-Types.html#gchar"
84
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-vcard-field-test" title="e_book_query_vcard_field_test ()">e_book_query_vcard_field_test</a> (const <a
85
href="../glib/glib-Basic-Types.html#gchar"
65
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-vcard-field-test" title="e_book_query_vcard_field_test ()">e_book_query_vcard_field_test</a> (const gchar *field,
87
66
<a class="link" href="libebook-e-book-query.html#EBookQueryTest" title="enum EBookQueryTest">EBookQueryTest</a> test,
89
href="../glib/glib-Basic-Types.html#gchar"
91
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-any-field-contains" title="e_book_query_any_field_contains ()">e_book_query_any_field_contains</a> (const <a
92
href="../glib/glib-Basic-Types.html#gchar"
68
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-any-field-contains" title="e_book_query_any_field_contains ()">e_book_query_any_field_contains</a> (const gchar *value);
94
69
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* <a class="link" href="libebook-e-book-query.html#e-book-query-copy" title="e_book_query_copy ()">e_book_query_copy</a> (<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a> *q);
230
193
<div class="refsect2" lang="en">
231
194
<a name="e-book-query-and"></a><h3>e_book_query_and ()</h3>
232
<pre class="programlisting"><a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* e_book_query_and (<a
233
href="../glib/glib-Basic-Types.html#gint"
195
<pre class="programlisting"><a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* e_book_query_and (gint nqs,
235
196
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a> **qs,
237
href="../glib/glib-Basic-Types.html#gboolean"
238
>gboolean</a> unref);</pre>
197
gboolean unref);</pre>
240
199
Create a new <a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery"><span class="type">EBookQuery</span></a> which is the logical AND of the queries in <span class="type">qs</span>.</p>
243
200
<div class="variablelist"><table border="0">
244
201
<col align="left" valign="top">
304
255
<div class="refsect2" lang="en">
305
256
<a name="e-book-query-or"></a><h3>e_book_query_or ()</h3>
306
<pre class="programlisting"><a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* e_book_query_or (<a
307
href="../glib/glib-Basic-Types.html#gint"
257
<pre class="programlisting"><a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* e_book_query_or (gint nqs,
309
258
<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a> **qs,
311
href="../glib/glib-Basic-Types.html#gboolean"
312
>gboolean</a> unref);</pre>
259
gboolean unref);</pre>
314
261
Creates a new <a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery"><span class="type">EBookQuery</span></a> which is the logical OR of the queries in <span class="type">qs</span>.</p>
317
262
<div class="variablelist"><table border="0">
318
263
<col align="left" valign="top">
378
317
<div class="refsect2" lang="en">
379
318
<a name="e-book-query-not"></a><h3>e_book_query_not ()</h3>
380
319
<pre class="programlisting"><a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* e_book_query_not (<a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a> *q,
382
href="../glib/glib-Basic-Types.html#gboolean"
383
>gboolean</a> unref);</pre>
385
Creates a new <a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery"><span class="type">EBookQuery</span></a> which is the opposite of <span class="type">q</span>.</p>
320
gboolean unref);</pre>
322
Creates a new <a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery"><span class="type">EBookQuery</span></a> which is the opposite of #q.</p>
388
323
<div class="variablelist"><table border="0">
389
324
<col align="left" valign="top">
436
367
<div class="refsect2" lang="en">
437
368
<a name="e-book-query-vcard-field-exists"></a><h3>e_book_query_vcard_field_exists ()</h3>
438
<pre class="programlisting"><a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* e_book_query_vcard_field_exists (const <a
439
href="../glib/glib-Basic-Types.html#gchar"
440
>gchar</a> *field);</pre>
369
<pre class="programlisting"><a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* e_book_query_vcard_field_exists (const gchar *field);</pre>
442
371
Creates a new <a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery"><span class="type">EBookQuery</span></a> which tests if the field <em class="parameter"><code>field</code></em> exists. <em class="parameter"><code>field</code></em>
443
372
should be a vCard field name, such as <span class="type">FN</span> or <span class="type">X-MSN</span>.</p>
446
373
<div class="variablelist"><table border="0">
447
374
<col align="left" valign="top">
464
391
<a name="e-book-query-field-test"></a><h3>e_book_query_field_test ()</h3>
465
392
<pre class="programlisting"><a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* e_book_query_field_test (<a class="link" href="EContact.html#EContactField" title="enum EContactField">EContactField</a> field,
466
393
<a class="link" href="libebook-e-book-query.html#EBookQueryTest" title="enum EBookQueryTest">EBookQueryTest</a> test,
468
href="../glib/glib-Basic-Types.html#gchar"
469
>gchar</a> *value);</pre>
394
const gchar *value);</pre>
471
396
Creates a new <a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery"><span class="type">EBookQuery</span></a> which tests <em class="parameter"><code>field</code></em> for <em class="parameter"><code>value</code></em> using the test <em class="parameter"><code>test</code></em>.</p>
474
397
<div class="variablelist"><table border="0">
475
398
<col align="left" valign="top">
501
424
<div class="refsect2" lang="en">
502
425
<a name="e-book-query-vcard-field-test"></a><h3>e_book_query_vcard_field_test ()</h3>
503
<pre class="programlisting"><a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* e_book_query_vcard_field_test (const <a
504
href="../glib/glib-Basic-Types.html#gchar"
426
<pre class="programlisting"><a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* e_book_query_vcard_field_test (const gchar *field,
506
427
<a class="link" href="libebook-e-book-query.html#EBookQueryTest" title="enum EBookQueryTest">EBookQueryTest</a> test,
508
href="../glib/glib-Basic-Types.html#gchar"
509
>gchar</a> *value);</pre>
428
const gchar *value);</pre>
511
430
Creates a new <a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery"><span class="type">EBookQuery</span></a> which tests <em class="parameter"><code>field</code></em> for <em class="parameter"><code>value</code></em> using the test <em class="parameter"><code>test</code></em>.</p>
514
431
<div class="variablelist"><table border="0">
515
432
<col align="left" valign="top">
541
458
<div class="refsect2" lang="en">
542
459
<a name="e-book-query-any-field-contains"></a><h3>e_book_query_any_field_contains ()</h3>
543
<pre class="programlisting"><a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* e_book_query_any_field_contains (const <a
544
href="../glib/glib-Basic-Types.html#gchar"
545
>gchar</a> *value);</pre>
460
<pre class="programlisting"><a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery">EBookQuery</a>* e_book_query_any_field_contains (const gchar *value);</pre>
547
462
Creates a new <a class="link" href="libebook-e-book-query.html#EBookQuery" title="EBookQuery"><span class="type">EBookQuery</span></a> which tests if any field contains <em class="parameter"><code>value</code></em>.</p>
550
463
<div class="variablelist"><table border="0">
551
464
<col align="left" valign="top">