← Back to branch summary

~ubuntu-branches/ubuntu/hardy/evolution-data-server/hardy-updates

« back to all changes in this revision

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

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2007-11-13 10:59:20 UTC
  • mfrom: (1.1.38 upstream)
  • Revision ID: james.westby@ubuntu.com-20071113105920-nb6w14udvgx0ghi3
Tags: 2.21.2-0ubuntu1
https://launchpad.net/bugs/23912
* New upstream version:
  Bug Fixes:
  - #318842: Task lists should be sorted (LP: #23912)
  - #345135: Disable SSLv2 compatible HELLO on SSL stream when 
    SSLv2 is disabled
  - #359267: Not all memos are showed in calendar view
  - #430420: Returned size <= 0 is an error
  - #460649: Meeting UI Needs To Show Color Of Selected Calendar Source
  - #487229: Use GKeyFile instead of gnome-config to access stored passwords
  - #488156: Minimize use of the WITH_GNOME_KEYRING macro
  - #492130: ESourceSelector uses pointers to ESource
  - #494304: Fix leak
  Updated Translations
  New in 2.21.1:
  - Support for Google Calendar
  Bug Fixes:
  - #203480: (Novell Bugzilla) Compiler warning fix 
    for usage ofunintialized variable
  - #231178: New symbol 'set-label' defined and added corresponding callback
  - #271777: Keep character's case as user types
  - #417999: Don't use deprecated GTK+ symbols
  - #420167: e-d-s now exits with gnome-session
  - #469657: Better use of GHashTable
  - #474000: Use GLib's Base64 API instead of Camel's
  - #475487: When creating the default contact, print errors to the console
  - #475493: Use G_DEFINE_TYPE
  - #475494: Use G_LOCK instead of a static mutex for clearer code
  - #478404: Reset the id to zero
  - #483301: Remove an unused variable
  - #487270: Fix typo in documentation
  - #488173: Remove __FUNCTION__, which is a gcc-ism
  - #488351: Fix an addressbook error on a fresh install
  Other Contributors:
  - Protect against a NULL subject string. 
* debian/*.preinst:
  - On upgrades from Gutsy, remove the symlinks introduced in Gutsy. They
    break upgrades all over, and current cdbs just symlinks individual files.
* Sync with Debian
* debian/control:
  - evolution-data-server Breaks evolution (<< 2.9), 
    evolution-exchange (<= 2.8.1-0ubuntu1),
    evolution-jescs (<= 2.8.2-0ubuntu3), 
    evolution-scalix (<= 10.0.0.357-0ubuntu6)
  - updated maintainer to desktop team
* debian/rules:
  - don't specify the paths for nspr and nss since the package is built 
    with firefox
  - don't build documentation, it's distributed in the upstream tarball

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/libedataserver/html/libedataserver-e-util.html
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
5
<title>Utility Functions</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.73.1">
7
7
<link rel="start" href="index.html" title="Evolution API Reference: libedataserver, utility library">
8
8
<link rel="up" href="ch01.html" title="Evolution API Reference: libedataserver, utility library">
9
9
<link rel="prev" href="libedataserver-e-uid.html" title="User ID Generation">
10
10
<link rel="next" href="libedataserver-e-url.html" title="EUrl">
11
 
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="ch01.html" title="Evolution API Reference: libedataserver, utility library">
14
14
<link rel="index" href="ix01.html" title="Index">
22
22
<th width="100%" align="center">Evolution API Reference: libedataserver, utility library</th>
23
23
<td><a accesskey="n" href="libedataserver-e-url.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
24
24
</tr>
25
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2586232" class="shortcut">Top</a>
 
25
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2598027" class="shortcut">Top</a>
26
26
                  &#160;|&#160;
27
 
                  <a href="#id2622791" class="shortcut">Description</a></nobr></td></tr>
 
27
                  <a href="#id2649092" class="shortcut">Description</a></nobr></td></tr>
28
28
</table>
29
29
<div class="refentry" lang="en">
30
30
<a name="libedataserver-e-util"></a><div class="titlepage"></div>
31
31
<div class="refnamediv"><table width="100%"><tr>
32
32
<td valign="top">
33
33
<h2>
34
 
<a name="id2586232"></a><span class="refentrytitle">Utility Functions</span>
 
34
<a name="id2598027"></a><span class="refentrytitle">Utility Functions</span>
35
35
</h2>
36
36
<p>Utility Functions &#8212; Miscellaneous utility functions for evolution-data-server.</p>
37
37
</td>
43
43
 
44
44
 
45
45
 
46
 
struct              <a href="libedataserver-e-util.html#tm">tm</a>;
47
 
int                 <a href="libedataserver-e-util.html#e-util-mkdir-hier">e_util_mkdir_hier</a>                   (const char *path,
 
46
struct              <a class="link" href="libedataserver-e-util.html#tm">tm</a>;
 
47
int                 <a class="link" href="libedataserver-e-util.html#e-util-mkdir-hier">e_util_mkdir_hier</a>                   (const char *path,
48
48
                                                         mode_t mode);
49
 
<a
50
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
51
 
>gchar</a>*              <a href="libedataserver-e-util.html#e-util-strstrcase">e_util_strstrcase</a>                   (const <a
52
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
53
 
>gchar</a> *haystack,
54
 
                                                         const <a
55
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
56
 
>gchar</a> *needle);
57
 
<a
58
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
59
 
>gchar</a>*              <a href="libedataserver-e-util.html#e-util-unicode-get-utf8">e_util_unicode_get_utf8</a>             (const <a
60
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
61
 
>gchar</a> *text,
62
 
                                                         <a
63
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#gunichar"
64
 
>gunichar</a> *out);
65
 
const <a
66
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
67
 
>gchar</a>*        <a href="libedataserver-e-util.html#e-util-utf8-strstrcase">e_util_utf8_strstrcase</a>              (const <a
68
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
69
 
>gchar</a> *haystack,
70
 
                                                         const <a
71
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
72
 
>gchar</a> *needle);
73
 
const <a
74
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
75
 
>gchar</a>*        <a href="libedataserver-e-util.html#e-util-utf8-strstrcasedecomp">e_util_utf8_strstrcasedecomp</a>        (const <a
76
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
77
 
>gchar</a> *haystack,
78
 
                                                         const <a
79
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
80
 
>gchar</a> *needle);
81
 
int                 <a href="libedataserver-e-util.html#e-util-utf8-strcasecmp">e_util_utf8_strcasecmp</a>              (const <a
82
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
83
 
>gchar</a> *s1,
84
 
                                                         const <a
85
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
86
 
>gchar</a> *s2);
87
 
<a
88
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint64"
89
 
>guint64</a>             <a href="libedataserver-e-util.html#e-util-pthread-id">e_util_pthread_id</a>                   (pthread_t t);
90
 
void                <a href="libedataserver-e-util.html#e-filename-make-safe">e_filename_make_safe</a>                (<a
91
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
92
 
>gchar</a> *string);
93
 
size_t              <a href="libedataserver-e-util.html#e-utf8-strftime">e_utf8_strftime</a>                     (char *s,
94
 
                                                         size_t max,
95
 
                                                         const char *fmt,
96
 
                                                         const struct tm *tm);
97
 
size_t              <a href="libedataserver-e-util.html#e-strftime">e_strftime</a>                          (char *s,
98
 
                                                         size_t max,
99
 
                                                         const char *fmt,
100
 
                                                         const struct tm *tm);
101
 
const char*         <a href="libedataserver-e-util.html#e-util-get-prefix">e_util_get_prefix</a>                   (void);
102
 
const char*         <a href="libedataserver-e-util.html#e-util-get-cp-prefix">e_util_get_cp_prefix</a>                (void);
103
 
const char*         <a href="libedataserver-e-util.html#e-util-get-localedir">e_util_get_localedir</a>                (void);
104
 
char*               <a href="libedataserver-e-util.html#e-util-replace-prefix">e_util_replace_prefix</a>               (const char *configure_time_prefix,
 
49
gchar*              <a class="link" href="libedataserver-e-util.html#e-util-strstrcase">e_util_strstrcase</a>                   (const gchar *haystack,
 
50
                                                         const gchar *needle);
 
51
gchar*              <a class="link" href="libedataserver-e-util.html#e-util-unicode-get-utf8">e_util_unicode_get_utf8</a>             (const gchar *text,
 
52
                                                         gunichar *out);
 
53
const gchar*        <a class="link" href="libedataserver-e-util.html#e-util-utf8-strstrcase">e_util_utf8_strstrcase</a>              (const gchar *haystack,
 
54
                                                         const gchar *needle);
 
55
const gchar*        <a class="link" href="libedataserver-e-util.html#e-util-utf8-strstrcasedecomp">e_util_utf8_strstrcasedecomp</a>        (const gchar *haystack,
 
56
                                                         const gchar *needle);
 
57
int                 <a class="link" href="libedataserver-e-util.html#e-util-utf8-strcasecmp">e_util_utf8_strcasecmp</a>              (const gchar *s1,
 
58
                                                         const gchar *s2);
 
59
guint64             <a class="link" href="libedataserver-e-util.html#e-util-pthread-id">e_util_pthread_id</a>                   (pthread_t t);
 
60
void                <a class="link" href="libedataserver-e-util.html#e-filename-make-safe">e_filename_make_safe</a>                (gchar *string);
 
61
size_t              <a class="link" href="libedataserver-e-util.html#e-utf8-strftime">e_utf8_strftime</a>                     (char *s,
 
62
                                                         size_t max,
 
63
                                                         const char *fmt,
 
64
                                                         const struct tm *tm);
 
65
size_t              <a class="link" href="libedataserver-e-util.html#e-strftime">e_strftime</a>                          (char *s,
 
66
                                                         size_t max,
 
67
                                                         const char *fmt,
 
68
                                                         const struct tm *tm);
 
69
const char*         <a class="link" href="libedataserver-e-util.html#e-util-get-prefix">e_util_get_prefix</a>                   (void);
 
70
const char*         <a class="link" href="libedataserver-e-util.html#e-util-get-cp-prefix">e_util_get_cp_prefix</a>                (void);
 
71
const char*         <a class="link" href="libedataserver-e-util.html#e-util-get-localedir">e_util_get_localedir</a>                (void);
 
72
char*               <a class="link" href="libedataserver-e-util.html#e-util-replace-prefix">e_util_replace_prefix</a>               (const char *configure_time_prefix,
105
73
                                                         const char *runtime_prefix,
106
74
                                                         const char *configure_time_path);
107
75
</pre>
108
76
</div>
109
77
<div class="refsect1" lang="en">
110
 
<a name="id2622791"></a><h2>Description</h2>
 
78
<a name="id2649092"></a><h2>Description</h2>
111
79
<p>
112
80
 
113
81
</p>
114
82
</div>
115
83
<div class="refsect1" lang="en">
116
 
<a name="id2622807"></a><h2>Details</h2>
 
84
<a name="id2649108"></a><h2>Details</h2>
117
85
<div class="refsect2" lang="en">
118
 
<a name="id2622817"></a><h3>
 
86
<a name="id2649118"></a><h3>
119
87
<a name="tm"></a>struct tm</h3>
120
 
<a class="indexterm" name="id2622829"></a><pre class="programlisting">struct tm;</pre>
 
88
<a class="indexterm" name="id2649130"></a><pre class="programlisting">struct tm;</pre>
121
89
<p>
122
90
 
123
91
</p>
124
92
</div>
125
93
<hr>
126
94
<div class="refsect2" lang="en">
127
 
<a name="id2622845"></a><h3>
 
95
<a name="id2649146"></a><h3>
128
96
<a name="e-util-mkdir-hier"></a>e_util_mkdir_hier ()</h3>
129
 
<a class="indexterm" name="id2622860"></a><pre class="programlisting">int                 e_util_mkdir_hier                   (const char *path,
 
97
<a class="indexterm" name="id2649161"></a><pre class="programlisting">int                 e_util_mkdir_hier                   (const char *path,
130
98
                                                         mode_t mode);</pre>
131
99
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
132
100
<h3 class="title">Warning</h3>
144
112
<col align="left" valign="top">
145
113
<tbody>
146
114
<tr>
147
 
<td><span class="term"><em class="parameter"><code>path</code></em>&#160;:</span></td>
 
115
<td><p><span class="term"><em class="parameter"><code>path</code></em>&#160;:</span></p></td>
148
116
<td> The directory hierarchy to create.
149
117
</td>
150
118
</tr>
151
119
<tr>
152
 
<td><span class="term"><em class="parameter"><code>mode</code></em>&#160;:</span></td>
 
120
<td><p><span class="term"><em class="parameter"><code>mode</code></em>&#160;:</span></p></td>
153
121
<td> The permissions to use for the directories.
154
122
</td>
155
123
</tr>
156
124
<tr>
157
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
125
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
158
126
<td> 0 on success; -1 on failure.
159
127
</td>
160
128
</tr>
163
131
</div>
164
132
<hr>
165
133
<div class="refsect2" lang="en">
166
 
<a name="id2614925"></a><h3>
 
134
<a name="id2649270"></a><h3>
167
135
<a name="e-util-strstrcase"></a>e_util_strstrcase ()</h3>
168
 
<a class="indexterm" name="id2614937"></a><pre class="programlisting"><a
169
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
170
 
>gchar</a>*              e_util_strstrcase                   (const <a
171
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
172
 
>gchar</a> *haystack,
173
 
                                                         const <a
174
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
175
 
>gchar</a> *needle);</pre>
 
136
<a class="indexterm" name="id2649283"></a><pre class="programlisting">gchar*              e_util_strstrcase                   (const gchar *haystack,
 
137
                                                         const gchar *needle);</pre>
176
138
<p>
177
139
Find the first instance of <em class="parameter"><code>needle</code></em> in <em class="parameter"><code>haystack</code></em>, ignoring case for
178
140
bytes that are ASCII characters.</p>
183
145
<col align="left" valign="top">
184
146
<tbody>
185
147
<tr>
186
 
<td><span class="term"><em class="parameter"><code>haystack</code></em>&#160;:</span></td>
 
148
<td><p><span class="term"><em class="parameter"><code>haystack</code></em>&#160;:</span></p></td>
187
149
<td> The string to search in.
188
150
</td>
189
151
</tr>
190
152
<tr>
191
 
<td><span class="term"><em class="parameter"><code>needle</code></em>&#160;:</span></td>
 
153
<td><p><span class="term"><em class="parameter"><code>needle</code></em>&#160;:</span></p></td>
192
154
<td> The string to search for.
193
155
</td>
194
156
</tr>
195
157
<tr>
196
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
158
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
197
159
<td> A pointer to the start of <em class="parameter"><code>needle</code></em> in <em class="parameter"><code>haystack</code></em>, or NULL if
198
160
         <em class="parameter"><code>needle</code></em> is not found.
199
161
</td>
203
165
</div>
204
166
<hr>
205
167
<div class="refsect2" lang="en">
206
 
<a name="id2615048"></a><h3>
 
168
<a name="id2649394"></a><h3>
207
169
<a name="e-util-unicode-get-utf8"></a>e_util_unicode_get_utf8 ()</h3>
208
 
<a class="indexterm" name="id2615059"></a><pre class="programlisting"><a
209
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
210
 
>gchar</a>*              e_util_unicode_get_utf8             (const <a
211
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
212
 
>gchar</a> *text,
213
 
                                                         <a
214
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#gunichar"
215
 
>gunichar</a> *out);</pre>
 
170
<a class="indexterm" name="id2649405"></a><pre class="programlisting">gchar*              e_util_unicode_get_utf8             (const gchar *text,
 
171
                                                         gunichar *out);</pre>
216
172
<p>
217
173
Get a UTF-8 character from the beginning of <em class="parameter"><code>text</code></em>.</p>
218
174
<p>
222
178
<col align="left" valign="top">
223
179
<tbody>
224
180
<tr>
225
 
<td><span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></td>
 
181
<td><p><span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></p></td>
226
182
<td> The string to take the UTF-8 character from.
227
183
</td>
228
184
</tr>
229
185
<tr>
230
 
<td><span class="term"><em class="parameter"><code>out</code></em>&#160;:</span></td>
 
186
<td><p><span class="term"><em class="parameter"><code>out</code></em>&#160;:</span></p></td>
231
187
<td> The location to store the UTF-8 character in.
232
188
</td>
233
189
</tr>
234
190
<tr>
235
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
191
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
236
192
<td> A pointer to the next character in <em class="parameter"><code>text</code></em> after <em class="parameter"><code>out</code></em>. 
237
193
</td>
238
194
</tr>
241
197
</div>
242
198
<hr>
243
199
<div class="refsect2" lang="en">
244
 
<a name="id2615160"></a><h3>
 
200
<a name="id2649506"></a><h3>
245
201
<a name="e-util-utf8-strstrcase"></a>e_util_utf8_strstrcase ()</h3>
246
 
<a class="indexterm" name="id2615172"></a><pre class="programlisting">const <a
247
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
248
 
>gchar</a>*        e_util_utf8_strstrcase              (const <a
249
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
250
 
>gchar</a> *haystack,
251
 
                                                         const <a
252
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
253
 
>gchar</a> *needle);</pre>
 
202
<a class="indexterm" name="id2649517"></a><pre class="programlisting">const gchar*        e_util_utf8_strstrcase              (const gchar *haystack,
 
203
                                                         const gchar *needle);</pre>
254
204
<p>
255
205
Find the first instance of <em class="parameter"><code>needle</code></em> in <em class="parameter"><code>haystack</code></em>, ignoring case. (No
256
206
proper case folding or decomposing is done.) Both <em class="parameter"><code>needle</code></em> and
262
212
<col align="left" valign="top">
263
213
<tbody>
264
214
<tr>
265
 
<td><span class="term"><em class="parameter"><code>haystack</code></em>&#160;:</span></td>
 
215
<td><p><span class="term"><em class="parameter"><code>haystack</code></em>&#160;:</span></p></td>
266
216
<td> The string to search in.
267
217
</td>
268
218
</tr>
269
219
<tr>
270
 
<td><span class="term"><em class="parameter"><code>needle</code></em>&#160;:</span></td>
 
220
<td><p><span class="term"><em class="parameter"><code>needle</code></em>&#160;:</span></p></td>
271
221
<td> The string to search for.
272
222
</td>
273
223
</tr>
274
224
<tr>
275
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
225
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
276
226
<td> A pointer to the first instance of <em class="parameter"><code>needle</code></em> in <em class="parameter"><code>haystack</code></em>, or
277
 
         <a
278
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
279
 
><code class="literal">NULL</code></a> if no match is found, or if either of the strings are
 
227
         <code class="literal">NULL</code> if no match is found, or if either of the strings are
280
228
         not legal UTF-8 strings.
281
229
</td>
282
230
</tr>
285
233
</div>
286
234
<hr>
287
235
<div class="refsect2" lang="en">
288
 
<a name="id2623469"></a><h3>
 
236
<a name="id2652075"></a><h3>
289
237
<a name="e-util-utf8-strstrcasedecomp"></a>e_util_utf8_strstrcasedecomp ()</h3>
290
 
<a class="indexterm" name="id2623480"></a><pre class="programlisting">const <a
291
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
292
 
>gchar</a>*        e_util_utf8_strstrcasedecomp        (const <a
293
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
294
 
>gchar</a> *haystack,
295
 
                                                         const <a
296
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
297
 
>gchar</a> *needle);</pre>
 
238
<a class="indexterm" name="id2652086"></a><pre class="programlisting">const gchar*        e_util_utf8_strstrcasedecomp        (const gchar *haystack,
 
239
                                                         const gchar *needle);</pre>
298
240
<p>
299
241
Find the first instance of <em class="parameter"><code>needle</code></em> in <em class="parameter"><code>haystack</code></em>, where both <em class="parameter"><code>needle</code></em>
300
242
and <em class="parameter"><code>haystack</code></em> are UTF-8 strings. Both strings are stripped and
306
248
<col align="left" valign="top">
307
249
<tbody>
308
250
<tr>
309
 
<td><span class="term"><em class="parameter"><code>haystack</code></em>&#160;:</span></td>
 
251
<td><p><span class="term"><em class="parameter"><code>haystack</code></em>&#160;:</span></p></td>
310
252
<td> The string to search in.
311
253
</td>
312
254
</tr>
313
255
<tr>
314
 
<td><span class="term"><em class="parameter"><code>needle</code></em>&#160;:</span></td>
 
256
<td><p><span class="term"><em class="parameter"><code>needle</code></em>&#160;:</span></p></td>
315
257
<td> The string to search for.
316
258
</td>
317
259
</tr>
318
260
<tr>
319
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
261
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
320
262
<td> A pointer to the first instance of <em class="parameter"><code>needle</code></em> in <em class="parameter"><code>haystack</code></em>, or
321
 
         <a
322
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"
323
 
><code class="literal">NULL</code></a> if either of the strings are not legal UTF-8 strings.
 
263
         <code class="literal">NULL</code> if either of the strings are not legal UTF-8 strings.
324
264
</td>
325
265
</tr>
326
266
</tbody>
328
268
</div>
329
269
<hr>
330
270
<div class="refsect2" lang="en">
331
 
<a name="id2623611"></a><h3>
 
271
<a name="id2652202"></a><h3>
332
272
<a name="e-util-utf8-strcasecmp"></a>e_util_utf8_strcasecmp ()</h3>
333
 
<a class="indexterm" name="id2623622"></a><pre class="programlisting">int                 e_util_utf8_strcasecmp              (const <a
334
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
335
 
>gchar</a> *s1,
336
 
                                                         const <a
337
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
338
 
>gchar</a> *s2);</pre>
 
273
<a class="indexterm" name="id2652212"></a><pre class="programlisting">int                 e_util_utf8_strcasecmp              (const gchar *s1,
 
274
                                                         const gchar *s2);</pre>
339
275
<p>
340
276
 
341
277
</p>
343
279
<col align="left" valign="top">
344
280
<tbody>
345
281
<tr>
346
 
<td><span class="term"><em class="parameter"><code>s1</code></em>&#160;:</span></td>
347
 
<td>
348
 
</td>
349
 
</tr>
350
 
<tr>
351
 
<td><span class="term"><em class="parameter"><code>s2</code></em>&#160;:</span></td>
352
 
<td>
353
 
</td>
354
 
</tr>
355
 
<tr>
356
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
282
<td><p><span class="term"><em class="parameter"><code>s1</code></em>&#160;:</span></p></td>
 
283
<td>
 
284
</td>
 
285
</tr>
 
286
<tr>
 
287
<td><p><span class="term"><em class="parameter"><code>s2</code></em>&#160;:</span></p></td>
 
288
<td>
 
289
</td>
 
290
</tr>
 
291
<tr>
 
292
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
357
293
<td>
358
294
 
359
295
 
364
300
</div>
365
301
<hr>
366
302
<div class="refsect2" lang="en">
367
 
<a name="id2623700"></a><h3>
 
303
<a name="id2652289"></a><h3>
368
304
<a name="e-util-pthread-id"></a>e_util_pthread_id ()</h3>
369
 
<a class="indexterm" name="id2623712"></a><pre class="programlisting"><a
370
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#guint64"
371
 
>guint64</a>             e_util_pthread_id                   (pthread_t t);</pre>
 
305
<a class="indexterm" name="id2652301"></a><pre class="programlisting">guint64             e_util_pthread_id                   (pthread_t t);</pre>
372
306
<p>
373
307
Returns a 64-bit integer hopefully uniquely identifying the
374
308
thread. To be used in debugging output and logging only. To test
376
310
<code class="function">pthread_equal()</code>.
377
311
</p>
378
312
<p>
379
 
There is no guarantee that calling <a href="libedataserver-e-util.html#e-util-pthread-id"><code class="function">e_util_pthread_id()</code></a> on one
 
313
There is no guarantee that calling <a class="link" href="libedataserver-e-util.html#e-util-pthread-id"><code class="function">e_util_pthread_id()</code></a> on one
380
314
thread first and later after that thread has dies on another won't
381
315
return the same integer.
382
316
</p>
397
331
<col align="left" valign="top">
398
332
<tbody>
399
333
<tr>
400
 
<td><span class="term"><em class="parameter"><code>t</code></em>&#160;:</span></td>
 
334
<td><p><span class="term"><em class="parameter"><code>t</code></em>&#160;:</span></p></td>
401
335
<td> A pthread_t value
402
336
</td>
403
337
</tr>
404
338
<tr>
405
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
339
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
406
340
<td> A 64-bit integer.
407
341
</td>
408
342
</tr>
411
345
</div>
412
346
<hr>
413
347
<div class="refsect2" lang="en">
414
 
<a name="id2626082"></a><h3>
 
348
<a name="id2652404"></a><h3>
415
349
<a name="e-filename-make-safe"></a>e_filename_make_safe ()</h3>
416
 
<a class="indexterm" name="id2626092"></a><pre class="programlisting">void                e_filename_make_safe                (<a
417
 
href="/opt/gnome/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
418
 
>gchar</a> *string);</pre>
 
350
<a class="indexterm" name="id2652415"></a><pre class="programlisting">void                e_filename_make_safe                (gchar *string);</pre>
419
351
<p>
420
352
 
421
353
</p>
422
354
<div class="variablelist"><table border="0">
423
355
<col align="left" valign="top">
424
356
<tbody><tr>
425
 
<td><span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></td>
 
357
<td><p><span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></p></td>
426
358
<td>
427
359
 
428
360
 
432
364
</div>
433
365
<hr>
434
366
<div class="refsect2" lang="en">
435
 
<a name="id2626133"></a><h3>
 
367
<a name="id2652461"></a><h3>
436
368
<a name="e-utf8-strftime"></a>e_utf8_strftime ()</h3>
437
 
<a class="indexterm" name="id2626143"></a><pre class="programlisting">size_t              e_utf8_strftime                     (char *s,
 
369
<a class="indexterm" name="id2652473"></a><pre class="programlisting">size_t              e_utf8_strftime                     (char *s,
438
370
                                                         size_t max,
439
371
                                                         const char *fmt,
440
372
                                                         const struct tm *tm);</pre>
441
373
<p>
442
 
The UTF-8 equivalent of <a href="libedataserver-e-util.html#e-strftime"><code class="function">e_strftime()</code></a>.</p>
 
374
The UTF-8 equivalent of <a class="link" href="libedataserver-e-util.html#e-strftime"><code class="function">e_strftime()</code></a>.</p>
443
375
<p>
444
376
 
445
377
</p>
447
379
<col align="left" valign="top">
448
380
<tbody>
449
381
<tr>
450
 
<td><span class="term"><em class="parameter"><code>s</code></em>&#160;:</span></td>
 
382
<td><p><span class="term"><em class="parameter"><code>s</code></em>&#160;:</span></p></td>
451
383
<td> The string array to store the result in.
452
384
</td>
453
385
</tr>
454
386
<tr>
455
 
<td><span class="term"><em class="parameter"><code>max</code></em>&#160;:</span></td>
 
387
<td><p><span class="term"><em class="parameter"><code>max</code></em>&#160;:</span></p></td>
456
388
<td> The size of array <em class="parameter"><code>s</code></em>.
457
389
</td>
458
390
</tr>
459
391
<tr>
460
 
<td><span class="term"><em class="parameter"><code>fmt</code></em>&#160;:</span></td>
 
392
<td><p><span class="term"><em class="parameter"><code>fmt</code></em>&#160;:</span></p></td>
461
393
<td> The formatting to use on <em class="parameter"><code>tm</code></em>.
462
394
</td>
463
395
</tr>
464
396
<tr>
465
 
<td><span class="term"><em class="parameter"><code>tm</code></em>&#160;:</span></td>
 
397
<td><p><span class="term"><em class="parameter"><code>tm</code></em>&#160;:</span></p></td>
466
398
<td> The time value to format.
467
399
</td>
468
400
</tr>
469
401
<tr>
470
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
402
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
471
403
<td> The number of characters placed in <em class="parameter"><code>s</code></em>.
472
404
</td>
473
405
</tr>
476
408
</div>
477
409
<hr>
478
410
<div class="refsect2" lang="en">
479
 
<a name="id2626287"></a><h3>
 
411
<a name="id2652625"></a><h3>
480
412
<a name="e-strftime"></a>e_strftime ()</h3>
481
 
<a class="indexterm" name="id2626299"></a><pre class="programlisting">size_t              e_strftime                          (char *s,
 
413
<a class="indexterm" name="id2652637"></a><pre class="programlisting">size_t              e_strftime                          (char *s,
482
414
                                                         size_t max,
483
415
                                                         const char *fmt,
484
416
                                                         const struct tm *tm);</pre>
492
424
<col align="left" valign="top">
493
425
<tbody>
494
426
<tr>
495
 
<td><span class="term"><em class="parameter"><code>s</code></em>&#160;:</span></td>
 
427
<td><p><span class="term"><em class="parameter"><code>s</code></em>&#160;:</span></p></td>
496
428
<td> The string array to store the result in.
497
429
</td>
498
430
</tr>
499
431
<tr>
500
 
<td><span class="term"><em class="parameter"><code>max</code></em>&#160;:</span></td>
 
432
<td><p><span class="term"><em class="parameter"><code>max</code></em>&#160;:</span></p></td>
501
433
<td> The size of array <em class="parameter"><code>s</code></em>.
502
434
</td>
503
435
</tr>
504
436
<tr>
505
 
<td><span class="term"><em class="parameter"><code>fmt</code></em>&#160;:</span></td>
 
437
<td><p><span class="term"><em class="parameter"><code>fmt</code></em>&#160;:</span></p></td>
506
438
<td> The formatting to use on <em class="parameter"><code>tm</code></em>.
507
439
</td>
508
440
</tr>
509
441
<tr>
510
 
<td><span class="term"><em class="parameter"><code>tm</code></em>&#160;:</span></td>
 
442
<td><p><span class="term"><em class="parameter"><code>tm</code></em>&#160;:</span></p></td>
511
443
<td> The time value to format.
512
444
</td>
513
445
</tr>
514
446
<tr>
515
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
447
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
516
448
<td> The number of characters placed in <em class="parameter"><code>s</code></em>.
517
449
</td>
518
450
</tr>
521
453
</div>
522
454
<hr>
523
455
<div class="refsect2" lang="en">
524
 
<a name="id2626423"></a><h3>
 
456
<a name="id2652782"></a><h3>
525
457
<a name="e-util-get-prefix"></a>e_util_get_prefix ()</h3>
526
 
<a class="indexterm" name="id2626434"></a><pre class="programlisting">const char*         e_util_get_prefix                   (void);</pre>
 
458
<a class="indexterm" name="id2652795"></a><pre class="programlisting">const char*         e_util_get_prefix                   (void);</pre>
527
459
<p>
528
460
 
529
461
</p>
530
462
<div class="variablelist"><table border="0">
531
463
<col align="left" valign="top">
532
464
<tbody><tr>
533
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
465
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
534
466
<td>
535
467
 
536
468
 
540
472
</div>
541
473
<hr>
542
474
<div class="refsect2" lang="en">
543
 
<a name="id2626467"></a><h3>
 
475
<a name="id2652832"></a><h3>
544
476
<a name="e-util-get-cp-prefix"></a>e_util_get_cp_prefix ()</h3>
545
 
<a class="indexterm" name="id2626478"></a><pre class="programlisting">const char*         e_util_get_cp_prefix                (void);</pre>
 
477
<a class="indexterm" name="id2652844"></a><pre class="programlisting">const char*         e_util_get_cp_prefix                (void);</pre>
546
478
<p>
547
479
 
548
480
</p>
549
481
<div class="variablelist"><table border="0">
550
482
<col align="left" valign="top">
551
483
<tbody><tr>
552
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
484
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
553
485
<td>
554
486
 
555
487
 
559
491
</div>
560
492
<hr>
561
493
<div class="refsect2" lang="en">
562
 
<a name="id2626511"></a><h3>
 
494
<a name="id2652881"></a><h3>
563
495
<a name="e-util-get-localedir"></a>e_util_get_localedir ()</h3>
564
 
<a class="indexterm" name="id2626522"></a><pre class="programlisting">const char*         e_util_get_localedir                (void);</pre>
 
496
<a class="indexterm" name="id2652892"></a><pre class="programlisting">const char*         e_util_get_localedir                (void);</pre>
565
497
<p>
566
498
 
567
499
</p>
568
500
<div class="variablelist"><table border="0">
569
501
<col align="left" valign="top">
570
502
<tbody><tr>
571
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
503
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
572
504
<td>
573
505
 
574
506
 
578
510
</div>
579
511
<hr>
580
512
<div class="refsect2" lang="en">
581
 
<a name="id2626555"></a><h3>
 
513
<a name="id2652930"></a><h3>
582
514
<a name="e-util-replace-prefix"></a>e_util_replace_prefix ()</h3>
583
 
<a class="indexterm" name="id2626566"></a><pre class="programlisting">char*               e_util_replace_prefix               (const char *configure_time_prefix,
 
515
<a class="indexterm" name="id2652941"></a><pre class="programlisting">char*               e_util_replace_prefix               (const char *configure_time_prefix,
584
516
                                                         const char *runtime_prefix,
585
517
                                                         const char *configure_time_path);</pre>
586
518
<p>
590
522
<col align="left" valign="top">
591
523
<tbody>
592
524
<tr>
593
 
<td><span class="term"><em class="parameter"><code>configure_time_prefix</code></em>&#160;:</span></td>
594
 
<td>
595
 
</td>
596
 
</tr>
597
 
<tr>
598
 
<td><span class="term"><em class="parameter"><code>runtime_prefix</code></em>&#160;:</span></td>
599
 
<td>
600
 
</td>
601
 
</tr>
602
 
<tr>
603
 
<td><span class="term"><em class="parameter"><code>configure_time_path</code></em>&#160;:</span></td>
604
 
<td>
605
 
</td>
606
 
</tr>
607
 
<tr>
608
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
525
<td><p><span class="term"><em class="parameter"><code>configure_time_prefix</code></em>&#160;:</span></p></td>
 
526
<td>
 
527
</td>
 
528
</tr>
 
529
<tr>
 
530
<td><p><span class="term"><em class="parameter"><code>runtime_prefix</code></em>&#160;:</span></p></td>
 
531
<td>
 
532
</td>
 
533
</tr>
 
534
<tr>
 
535
<td><p><span class="term"><em class="parameter"><code>configure_time_path</code></em>&#160;:</span></p></td>
 
536
<td>
 
537
</td>
 
538
</tr>
 
539
<tr>
 
540
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
609
541
<td>
610
542
 
611
543
 
616
548
</div>
617
549
</div>
618
550
<div class="refsect1" lang="en">
619
 
<a name="id2626656"></a><div class="refsect2" lang="en"><a name="id2626657"></a></div>
 
551
<a name="id2653041"></a><div class="refsect2" lang="en"><a name="id2653042"></a></div>
620
552
<hr>
621
 
<div class="refsect2" lang="en"><a name="id2626658"></a></div>
 
553
<div class="refsect2" lang="en"><a name="id2653044"></a></div>
622
554
</div>
623
555
</div>
624
556
</body>