~ubuntu-branches/ubuntu/natty/evolution-data-server/natty

« back to all changes in this revision

Viewing changes to docs/reference/libedataserver/html/libedataserver-e-trie.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2010-03-01 22:47:15 UTC
  • mfrom: (1.1.77 upstream)
  • Revision ID: james.westby@ubuntu.com-20100301224715-drsxc2y3t8anz3c0
Tags: 2.28.3-0ubuntu1
* New upstream version:
  Bug Fixes:
  - #602723 - Contact list name doesn't get displayed in 'To' dialog 
  - #600322 - assertion failed: (reply == msg) in cs_waitinfo()
              (lp: #455020, #475147)
  - #564727 - Few memory leaks (lp: #305428)
  - #574940 - Always ref returned info from message_info_from_uid 
              (lp: #341909)
  - #429317 - Use the relative URI returned if the server 
              re-directs a request
  - #602820 - Test validity of a book_view before using it in LDAP 
  - #590762 - Recurring google calendar items are not changeable
  - #604236 - Slow GPG processing 
  - #597816 - Do not crash on incorrect parameters used in sexp to SQL 
              (lp: #444177)
  - #604544 - Try Exchange fallback authentication only once 
  - #600778 - Fix --enable-e2k-debug configure option resolution 
  - #260407 - 'endswith' address book search doesn't work 
  - #549221 - (bnc) delete, sync flags immediately
* debian/patches/99_reconfigure.patch:
  - new version update

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>ETrie</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
7
7
<link rel="home" href="index.html" title="Evolution-Data-Server Manual: Utilities (libedataserver)">
8
8
<link rel="up" href="ch01.html" title="Evolution-Data-Server Manual: Utilities (libedataserver)">
9
9
<link rel="prev" href="libedataserver-e-time-utils.html" title="Time-Related Utility Functions">
10
10
<link rel="next" href="libedataserver-e-uid.html" title="User ID Generation">
11
 
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
 
<link rel="chapter" href="ch01.html" title="Evolution-Data-Server Manual: Utilities (libedataserver)">
14
 
<link rel="index" href="ix01.html" title="Index">
15
13
</head>
16
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
17
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
24
22
</tr>
25
23
<tr><td colspan="5" class="shortcuts">
26
24
<a href="#libedataserver-e-trie.synopsis" class="shortcut">Top</a>
27
 
                 | 
28
 
                <a href="#libedataserver-e-trie.description" class="shortcut">Description</a>
 
25
                   | 
 
26
                  <a href="#libedataserver-e-trie.description" class="shortcut">Description</a>
29
27
</td></tr>
30
28
</table>
31
 
<div class="refentry" title="ETrie">
 
29
<div class="refentry" lang="en">
32
30
<a name="libedataserver-e-trie"></a><div class="titlepage"></div>
33
31
<div class="refnamediv"><table width="100%"><tr>
34
32
<td valign="top">
37
35
</td>
38
36
<td valign="top" align="right"></td>
39
37
</tr></table></div>
40
 
<div class="refsynopsisdiv" title="Synopsis">
 
38
<div class="refsynopsisdiv">
41
39
<a name="libedataserver-e-trie.synopsis"></a><h2>Synopsis</h2>
42
 
<pre class="synopsis">
43
 
                    <a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie">ETrie</a>;
44
 
<a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie">ETrie</a> *             <a class="link" href="libedataserver-e-trie.html#e-trie-new" title="e_trie_new ()">e_trie_new</a>                          (<a
45
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
46
 
>gboolean</a> icase);
47
 
void                <a class="link" href="libedataserver-e-trie.html#e-trie-free" title="e_trie_free ()">e_trie_free</a>                         (<a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie">ETrie</a> *trie);
48
 
void                <a class="link" href="libedataserver-e-trie.html#e-trie-add" title="e_trie_add ()">e_trie_add</a>                          (<a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie">ETrie</a> *trie,
49
 
                                                         const <a
50
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
51
 
>gchar</a> *pattern,
52
 
                                                         <a
53
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
54
 
>gint</a> pattern_id);
55
 
const <a
56
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
57
 
>gchar</a> *       <a class="link" href="libedataserver-e-trie.html#e-trie-search" title="e_trie_search ()">e_trie_search</a>                       (<a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie">ETrie</a> *trie,
58
 
                                                         const <a
59
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
60
 
>gchar</a> *buffer,
61
 
                                                         <a
62
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"
63
 
>gsize</a> buflen,
64
 
                                                         <a
65
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
66
 
>gint</a> *matched_id);
 
40
<pre class="synopsis">                    <a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie">ETrie</a>;
 
41
<a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="returnvalue">ETrie</span></a> *             <a class="link" href="libedataserver-e-trie.html#e-trie-new" title="e_trie_new ()">e_trie_new</a>                          (<em class="parameter"><code><span class="type">gboolean</span> icase</code></em>);
 
42
<span class="returnvalue">void</span>                <a class="link" href="libedataserver-e-trie.html#e-trie-free" title="e_trie_free ()">e_trie_free</a>                         (<em class="parameter"><code><a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="type">ETrie</span></a> *trie</code></em>);
 
43
<span class="returnvalue">void</span>                <a class="link" href="libedataserver-e-trie.html#e-trie-add" title="e_trie_add ()">e_trie_add</a>                          (<em class="parameter"><code><a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="type">ETrie</span></a> *trie</code></em>,
 
44
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *pattern</code></em>,
 
45
                                                         <em class="parameter"><code><span class="type">gint</span> pattern_id</code></em>);
 
46
const <span class="returnvalue">gchar</span> *       <a class="link" href="libedataserver-e-trie.html#e-trie-search" title="e_trie_search ()">e_trie_search</a>                       (<em class="parameter"><code><a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="type">ETrie</span></a> *trie</code></em>,
 
47
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *buffer</code></em>,
 
48
                                                         <em class="parameter"><code><span class="type">gsize</span> buflen</code></em>,
 
49
                                                         <em class="parameter"><code><span class="type">gint</span> *matched_id</code></em>);
67
50
</pre>
68
51
</div>
69
 
<div class="refsect1" title="Description">
 
52
<div class="refsect1" lang="en">
70
53
<a name="libedataserver-e-trie.description"></a><h2>Description</h2>
71
54
<p>
72
55
</p>
73
56
</div>
74
 
<div class="refsect1" title="Details">
 
57
<div class="refsect1" lang="en">
75
58
<a name="libedataserver-e-trie.details"></a><h2>Details</h2>
76
 
<div class="refsect2" title="ETrie">
 
59
<div class="refsect2" lang="en">
77
60
<a name="ETrie"></a><h3>ETrie</h3>
78
61
<pre class="programlisting">typedef struct _ETrie ETrie;</pre>
79
 
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
62
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
80
63
<h3 class="title">Warning</h3>
81
64
<p><code class="literal">ETrie</code> is deprecated and should not be used in newly-written code.</p>
82
65
</div>
83
66
<p>
84
67
A trie data structure.</p>
85
 
<p>
86
 
</p>
87
68
</div>
88
69
<hr>
89
 
<div class="refsect2" title="e_trie_new ()">
 
70
<div class="refsect2" lang="en">
90
71
<a name="e-trie-new"></a><h3>e_trie_new ()</h3>
91
 
<pre class="programlisting"><a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie">ETrie</a> *             e_trie_new                          (<a
92
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
93
 
>gboolean</a> icase);</pre>
94
 
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
72
<pre class="programlisting"><a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="returnvalue">ETrie</span></a> *             e_trie_new                          (<em class="parameter"><code><span class="type">gboolean</span> icase</code></em>);</pre>
 
73
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
95
74
<h3 class="title">Warning</h3>
96
75
<p><code class="literal">e_trie_new</code> is deprecated and should not be used in newly-written code.</p>
97
76
</div>
98
77
<p>
99
 
Creates a new <a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="type">ETrie</span></a>. If <em class="parameter"><code>icase</code></em> is <a
100
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE--CAPS"
101
 
><code class="literal">TRUE</code></a>, then pattern matching
 
78
Creates a new <a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="type">ETrie</span></a>. If <em class="parameter"><code>icase</code></em> is <code class="literal">TRUE</code>, then pattern matching
102
79
done by the ETrie will be case insensitive.</p>
103
 
<p>
104
 
</p>
105
80
<div class="variablelist"><table border="0">
106
81
<col align="left" valign="top">
107
82
<tbody>
108
83
<tr>
109
84
<td><p><span class="term"><em class="parameter"><code>icase</code></em> :</span></p></td>
110
 
<td> Case sensitivity for the <a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="type">ETrie</span></a>.
 
85
<td>Case sensitivity for the <a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="type">ETrie</span></a>.
111
86
</td>
112
87
</tr>
113
88
<tr>
119
94
</table></div>
120
95
</div>
121
96
<hr>
122
 
<div class="refsect2" title="e_trie_free ()">
 
97
<div class="refsect2" lang="en">
123
98
<a name="e-trie-free"></a><h3>e_trie_free ()</h3>
124
 
<pre class="programlisting">void                e_trie_free                         (<a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie">ETrie</a> *trie);</pre>
125
 
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
99
<pre class="programlisting"><span class="returnvalue">void</span>                e_trie_free                         (<em class="parameter"><code><a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="type">ETrie</span></a> *trie</code></em>);</pre>
 
100
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
126
101
<h3 class="title">Warning</h3>
127
102
<p><code class="literal">e_trie_free</code> is deprecated and should not be used in newly-written code.</p>
128
103
</div>
129
104
<p>
130
105
Frees the memory associated with the <a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="type">ETrie</span></a> <em class="parameter"><code>trie</code></em>.</p>
131
 
<p>
132
 
</p>
133
106
<div class="variablelist"><table border="0">
134
107
<col align="left" valign="top">
135
108
<tbody><tr>
136
109
<td><p><span class="term"><em class="parameter"><code>trie</code></em> :</span></p></td>
137
 
<td> The <a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="type">ETrie</span></a> to free.
 
110
<td>The <a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="type">ETrie</span></a> to free.
138
111
</td>
139
112
</tr></tbody>
140
113
</table></div>
141
114
</div>
142
115
<hr>
143
 
<div class="refsect2" title="e_trie_add ()">
 
116
<div class="refsect2" lang="en">
144
117
<a name="e-trie-add"></a><h3>e_trie_add ()</h3>
145
 
<pre class="programlisting">void                e_trie_add                          (<a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie">ETrie</a> *trie,
146
 
                                                         const <a
147
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
148
 
>gchar</a> *pattern,
149
 
                                                         <a
150
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
151
 
>gint</a> pattern_id);</pre>
152
 
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
118
<pre class="programlisting"><span class="returnvalue">void</span>                e_trie_add                          (<em class="parameter"><code><a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="type">ETrie</span></a> *trie</code></em>,
 
119
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *pattern</code></em>,
 
120
                                                         <em class="parameter"><code><span class="type">gint</span> pattern_id</code></em>);</pre>
 
121
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
153
122
<h3 class="title">Warning</h3>
154
123
<p><code class="literal">e_trie_add</code> is deprecated and should not be used in newly-written code.</p>
155
124
</div>
156
125
<p>
157
126
Add a new pattern to the <a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="type">ETrie</span></a> <em class="parameter"><code>trie</code></em>.</p>
158
 
<p>
159
 
</p>
160
127
<div class="variablelist"><table border="0">
161
128
<col align="left" valign="top">
162
129
<tbody>
163
130
<tr>
164
131
<td><p><span class="term"><em class="parameter"><code>trie</code></em> :</span></p></td>
165
 
<td> The <a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="type">ETrie</span></a> to add a pattern to.
 
132
<td>The <a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="type">ETrie</span></a> to add a pattern to.
166
133
</td>
167
134
</tr>
168
135
<tr>
169
136
<td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
170
 
<td> The pattern to add.
 
137
<td>The pattern to add.
171
138
</td>
172
139
</tr>
173
140
<tr>
174
141
<td><p><span class="term"><em class="parameter"><code>pattern_id</code></em> :</span></p></td>
175
 
<td> The id to use for the pattern.
 
142
<td>The id to use for the pattern.
176
143
</td>
177
144
</tr>
178
145
</tbody>
179
146
</table></div>
180
147
</div>
181
148
<hr>
182
 
<div class="refsect2" title="e_trie_search ()">
 
149
<div class="refsect2" lang="en">
183
150
<a name="e-trie-search"></a><h3>e_trie_search ()</h3>
184
 
<pre class="programlisting">const <a
185
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
186
 
>gchar</a> *       e_trie_search                       (<a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie">ETrie</a> *trie,
187
 
                                                         const <a
188
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
189
 
>gchar</a> *buffer,
190
 
                                                         <a
191
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gsize"
192
 
>gsize</a> buflen,
193
 
                                                         <a
194
 
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
195
 
>gint</a> *matched_id);</pre>
196
 
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
151
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       e_trie_search                       (<em class="parameter"><code><a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="type">ETrie</span></a> *trie</code></em>,
 
152
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *buffer</code></em>,
 
153
                                                         <em class="parameter"><code><span class="type">gsize</span> buflen</code></em>,
 
154
                                                         <em class="parameter"><code><span class="type">gint</span> *matched_id</code></em>);</pre>
 
155
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
197
156
<h3 class="title">Warning</h3>
198
157
<p><code class="literal">e_trie_search</code> is deprecated and should not be used in newly-written code.</p>
199
158
</div>
200
159
<p>
201
160
Try to match the string <em class="parameter"><code>buffer</code></em> with a pattern in <em class="parameter"><code>trie</code></em>.</p>
202
 
<p>
203
 
</p>
204
161
<div class="variablelist"><table border="0">
205
162
<col align="left" valign="top">
206
163
<tbody>
207
164
<tr>
208
165
<td><p><span class="term"><em class="parameter"><code>trie</code></em> :</span></p></td>
209
 
<td> The <a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="type">ETrie</span></a> to search in.
 
166
<td>The <a class="link" href="libedataserver-e-trie.html#ETrie" title="ETrie"><span class="type">ETrie</span></a> to search in.
210
167
</td>
211
168
</tr>
212
169
<tr>
213
170
<td><p><span class="term"><em class="parameter"><code>buffer</code></em> :</span></p></td>
214
 
<td> The string to match against a pattern in <em class="parameter"><code>trie</code></em>.
 
171
<td>The string to match against a pattern in <em class="parameter"><code>trie</code></em>.
215
172
</td>
216
173
</tr>
217
174
<tr>
218
175
<td><p><span class="term"><em class="parameter"><code>buflen</code></em> :</span></p></td>
219
 
<td> The length of <em class="parameter"><code>buffer</code></em>.
 
176
<td>The length of <em class="parameter"><code>buffer</code></em>.
220
177
</td>
221
178
</tr>
222
179
<tr>
223
180
<td><p><span class="term"><em class="parameter"><code>matched_id</code></em> :</span></p></td>
224
 
<td> An integer address to store the matched pattern id in.
 
181
<td>An integer address to store the matched pattern id in.
225
182
</td>
226
183
</tr>
227
184
<tr>
228
185
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
229
 
<td> The matched pattern, or <a
230
 
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
231
 
><code class="literal">NULL</code></a> if no pattern is matched.
 
186
<td> The matched pattern, or <code class="literal">NULL</code> if no pattern is matched.
232
187
</td>
233
188
</tr>
234
189
</tbody>
238
193
</div>
239
194
<div class="footer">
240
195
<hr>
241
 
          Generated by GTK-Doc V1.11</div>
 
196
          Generated by GTK-Doc V1.14</div>
242
197
</body>
243
 
</html>
 
198
</html>
 
 
b'\\ No newline at end of file'