4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>Utility Functions</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
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-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.17.1 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.17 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
38
38
<div class="refsynopsisdiv">
39
39
<a name="libedataserver-e-util.synopsis"></a><h2>Synopsis</h2>
40
40
<pre class="synopsis">struct <a class="link" href="libedataserver-e-util.html#tm" title="struct tm">tm</a>;
41
const <span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-get-user-cache-dir" title="e_get_user_cache_dir ()">e_get_user_cache_dir</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
42
const <span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-get-user-config-dir" title="e_get_user_config_dir ()">e_get_user_config_dir</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
43
const <span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-get-user-data-dir" title="e_get_user_data_dir ()">e_get_user_data_dir</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
44
<span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-strstrcase" title="e_util_strstrcase ()">e_util_strstrcase</a> (<em class="parameter"><code>const <span class="type">gchar</span> *haystack</code></em>,
41
const <span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-get-user-cache-dir" title="e_get_user_cache_dir ()">e_get_user_cache_dir</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
42
const <span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-get-user-config-dir" title="e_get_user_config_dir ()">e_get_user_config_dir</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
43
const <span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-get-user-data-dir" title="e_get_user_data_dir ()">e_get_user_data_dir</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
44
<span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-strstrcase" title="e_util_strstrcase ()">e_util_strstrcase</a> (<em class="parameter"><code>const <span class="type">gchar</span> *haystack</code></em>,
45
45
<em class="parameter"><code>const <span class="type">gchar</span> *needle</code></em>);
46
<span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-unicode-get-utf8" title="e_util_unicode_get_utf8 ()">e_util_unicode_get_utf8</a> (<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
46
<span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-unicode-get-utf8" title="e_util_unicode_get_utf8 ()">e_util_unicode_get_utf8</a> (<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
47
47
<em class="parameter"><code><span class="type">gunichar</span> *out</code></em>);
48
const <span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-utf8-strstrcase" title="e_util_utf8_strstrcase ()">e_util_utf8_strstrcase</a> (<em class="parameter"><code>const <span class="type">gchar</span> *haystack</code></em>,
48
const <span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-utf8-strstrcase" title="e_util_utf8_strstrcase ()">e_util_utf8_strstrcase</a> (<em class="parameter"><code>const <span class="type">gchar</span> *haystack</code></em>,
49
49
<em class="parameter"><code>const <span class="type">gchar</span> *needle</code></em>);
50
const <span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-utf8-strstrcasedecomp" title="e_util_utf8_strstrcasedecomp ()">e_util_utf8_strstrcasedecomp</a> (<em class="parameter"><code>const <span class="type">gchar</span> *haystack</code></em>,
50
const <span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-utf8-strstrcasedecomp" title="e_util_utf8_strstrcasedecomp ()">e_util_utf8_strstrcasedecomp</a> (<em class="parameter"><code>const <span class="type">gchar</span> *haystack</code></em>,
51
51
<em class="parameter"><code>const <span class="type">gchar</span> *needle</code></em>);
52
52
<span class="returnvalue">gint</span> <a class="link" href="libedataserver-e-util.html#e-util-utf8-strcasecmp" title="e_util_utf8_strcasecmp ()">e_util_utf8_strcasecmp</a> (<em class="parameter"><code>const <span class="type">gchar</span> *s1</code></em>,
53
53
<em class="parameter"><code>const <span class="type">gchar</span> *s2</code></em>);
54
<span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-utf8-remove-accents" title="e_util_utf8_remove_accents ()">e_util_utf8_remove_accents</a> (<em class="parameter"><code>const <span class="type">gchar</span> *str</code></em>);
55
<span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-utf8-make-valid" title="e_util_utf8_make_valid ()">e_util_utf8_make_valid</a> (<em class="parameter"><code>const <span class="type">gchar</span> *str</code></em>);
54
<span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-utf8-remove-accents" title="e_util_utf8_remove_accents ()">e_util_utf8_remove_accents</a> (<em class="parameter"><code>const <span class="type">gchar</span> *str</code></em>);
55
<span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-utf8-make-valid" title="e_util_utf8_make_valid ()">e_util_utf8_make_valid</a> (<em class="parameter"><code>const <span class="type">gchar</span> *str</code></em>);
56
56
const <span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-ensure-gdbus-string" title="e_util_ensure_gdbus_string ()">e_util_ensure_gdbus_string</a> (<em class="parameter"><code>const <span class="type">gchar</span> *str</code></em>,
57
57
<em class="parameter"><code><span class="type">gchar</span> **gdbus_str</code></em>);
58
58
<span class="returnvalue">guint64</span> <a class="link" href="libedataserver-e-util.html#e-util-gthread-id" title="e_util_gthread_id ()">e_util_gthread_id</a> (<em class="parameter"><code><span class="type">GThread</span> *thread</code></em>);
65
65
<em class="parameter"><code><span class="type">gsize</span> max</code></em>,
66
66
<em class="parameter"><code>const <span class="type">gchar</span> *fmt</code></em>,
67
67
<em class="parameter"><code>const <span class="type">struct tm</span> *tm</code></em>);
68
const <span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-get-prefix" title="e_util_get_prefix ()">e_util_get_prefix</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
69
const <span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-get-cp-prefix" title="e_util_get_cp_prefix ()">e_util_get_cp_prefix</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
70
const <span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-get-localedir" title="e_util_get_localedir ()">e_util_get_localedir</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
71
<span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-replace-prefix" title="e_util_replace_prefix ()">e_util_replace_prefix</a> (<em class="parameter"><code>const <span class="type">gchar</span> *configure_time_prefix</code></em>,
68
const <span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-get-prefix" title="e_util_get_prefix ()">e_util_get_prefix</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
69
const <span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-get-cp-prefix" title="e_util_get_cp_prefix ()">e_util_get_cp_prefix</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
70
const <span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-get-localedir" title="e_util_get_localedir ()">e_util_get_localedir</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
71
<span class="returnvalue">gchar</span> * <a class="link" href="libedataserver-e-util.html#e-util-replace-prefix" title="e_util_replace_prefix ()">e_util_replace_prefix</a> (<em class="parameter"><code>const <span class="type">gchar</span> *configure_time_prefix</code></em>,
72
72
<em class="parameter"><code>const <span class="type">gchar</span> *runtime_prefix</code></em>,
73
73
<em class="parameter"><code>const <span class="type">gchar</span> *configure_time_path</code></em>);
74
74
<span class="returnvalue">gint</span> <a class="link" href="libedataserver-e-util.html#e-data-server-util-get-dbus-call-timeout" title="e_data_server_util_get_dbus_call_timeout ()">e_data_server_util_get_dbus_call_timeout</a>
162
162
<div class="refsect2">
163
163
<a name="e-util-strstrcase"></a><h3>e_util_strstrcase ()</h3>
164
<pre class="programlisting"><span class="returnvalue">gchar</span> * e_util_strstrcase (<em class="parameter"><code>const <span class="type">gchar</span> *haystack</code></em>,
164
<pre class="programlisting"><span class="returnvalue">gchar</span> * e_util_strstrcase (<em class="parameter"><code>const <span class="type">gchar</span> *haystack</code></em>,
165
165
<em class="parameter"><code>const <span class="type">gchar</span> *needle</code></em>);</pre>
167
167
Find the first instance of <em class="parameter"><code>needle</code></em> in <em class="parameter"><code>haystack</code></em>, ignoring case for
216
216
<div class="refsect2">
217
217
<a name="e-util-utf8-strstrcase"></a><h3>e_util_utf8_strstrcase ()</h3>
218
<pre class="programlisting">const <span class="returnvalue">gchar</span> * e_util_utf8_strstrcase (<em class="parameter"><code>const <span class="type">gchar</span> *haystack</code></em>,
218
<pre class="programlisting">const <span class="returnvalue">gchar</span> * e_util_utf8_strstrcase (<em class="parameter"><code>const <span class="type">gchar</span> *haystack</code></em>,
219
219
<em class="parameter"><code>const <span class="type">gchar</span> *needle</code></em>);</pre>
221
221
Find the first instance of <em class="parameter"><code>needle</code></em> in <em class="parameter"><code>haystack</code></em>, ignoring case. (No
246
246
<div class="refsect2">
247
247
<a name="e-util-utf8-strstrcasedecomp"></a><h3>e_util_utf8_strstrcasedecomp ()</h3>
248
<pre class="programlisting">const <span class="returnvalue">gchar</span> * e_util_utf8_strstrcasedecomp (<em class="parameter"><code>const <span class="type">gchar</span> *haystack</code></em>,
248
<pre class="programlisting">const <span class="returnvalue">gchar</span> * e_util_utf8_strstrcasedecomp (<em class="parameter"><code>const <span class="type">gchar</span> *haystack</code></em>,
249
249
<em class="parameter"><code>const <span class="type">gchar</span> *needle</code></em>);</pre>
251
251
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>
528
528
<div class="refsect2">
529
529
<a name="e-util-get-prefix"></a><h3>e_util_get_prefix ()</h3>
530
<pre class="programlisting">const <span class="returnvalue">gchar</span> * e_util_get_prefix (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
530
<pre class="programlisting">const <span class="returnvalue">gchar</span> * e_util_get_prefix (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
535
535
<div class="refsect2">
536
536
<a name="e-util-get-cp-prefix"></a><h3>e_util_get_cp_prefix ()</h3>
537
<pre class="programlisting">const <span class="returnvalue">gchar</span> * e_util_get_cp_prefix (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
537
<pre class="programlisting">const <span class="returnvalue">gchar</span> * e_util_get_cp_prefix (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
542
542
<div class="refsect2">
543
543
<a name="e-util-get-localedir"></a><h3>e_util_get_localedir ()</h3>
544
<pre class="programlisting">const <span class="returnvalue">gchar</span> * e_util_get_localedir (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
544
<pre class="programlisting">const <span class="returnvalue">gchar</span> * e_util_get_localedir (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
549
549
<div class="refsect2">
550
550
<a name="e-util-replace-prefix"></a><h3>e_util_replace_prefix ()</h3>
551
<pre class="programlisting"><span class="returnvalue">gchar</span> * e_util_replace_prefix (<em class="parameter"><code>const <span class="type">gchar</span> *configure_time_prefix</code></em>,
551
<pre class="programlisting"><span class="returnvalue">gchar</span> * e_util_replace_prefix (<em class="parameter"><code>const <span class="type">gchar</span> *configure_time_prefix</code></em>,
552
552
<em class="parameter"><code>const <span class="type">gchar</span> *runtime_prefix</code></em>,
553
553
<em class="parameter"><code>const <span class="type">gchar</span> *configure_time_path</code></em>);</pre>