1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
<title>empathy-utils</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
7
<link rel="start" href="index.html" title="libempathy Reference Manual">
8
<link rel="up" href="libempathy_api.html" title="libempathy API reference">
9
<link rel="prev" href="EmpathyIdle.html" title="EmpathyIdle">
10
<link rel="next" href="libempathy-hierarchy.html" title="Object Hierarchy">
11
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="part" href="pt01.html" title="Part I. libempathy Overview">
14
<link rel="part" href="pt02.html" title="Part II. API Reference">
15
<link rel="chapter" href="libempathy_api.html" title="libempathy API reference">
16
<link rel="chapter" href="libempathy-hierarchy.html" title="Object Hierarchy">
17
<link rel="index" href="ix01.html" title="Index">
19
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
20
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
22
<td><a accesskey="p" href="EmpathyIdle.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
23
<td><a accesskey="u" href="libempathy_api.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
24
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
25
<th width="100%" align="center">libempathy Reference Manual</th>
26
<td><a accesskey="n" href="libempathy-hierarchy.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
28
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id359710" class="shortcut">Top</a>
30
<a href="#id404132" class="shortcut">Description</a></nobr></td></tr>
32
<div class="refentry" lang="en">
33
<a name="libempathy-empathy-utils"></a><div class="titlepage"></div>
34
<div class="refnamediv"><table width="100%"><tr>
37
<a name="id359710"></a><span class="refentrytitle">empathy-utils</span>
41
<td valign="top" align="right"></td>
43
<div class="refsynopsisdiv">
45
<pre class="synopsis">
49
#define <a class="link" href="libempathy-empathy-utils.html#G-STR-EMPTY:CAPS">G_STR_EMPTY</a> (x)
50
enum <a class="link" href="libempathy-empathy-utils.html#EmpathyRegExType">EmpathyRegExType</a>;
51
gchar* <a class="link" href="libempathy-empathy-utils.html#empathy-substring">empathy_substring</a> (const gchar *str,
54
gint <a class="link" href="libempathy-empathy-utils.html#empathy-regex-match">empathy_regex_match</a> (<a class="link" href="libempathy-empathy-utils.html#EmpathyRegExType">EmpathyRegExType</a> type,
58
gint <a class="link" href="libempathy-empathy-utils.html#empathy-strcasecmp">empathy_strcasecmp</a> (const gchar *s1,
60
gint <a class="link" href="libempathy-empathy-utils.html#empathy-strncasecmp">empathy_strncasecmp</a> (const gchar *s1,
63
gboolean <a class="link" href="libempathy-empathy-utils.html#empathy-xml-validate">empathy_xml_validate</a> (xmlDoc *doc,
64
const gchar *dtd_filename);
65
xmlNodePtr <a class="link" href="libempathy-empathy-utils.html#empathy-xml-node-get-child">empathy_xml_node_get_child</a> (xmlNodePtr node,
66
const gchar *child_name);
67
xmlChar* <a class="link" href="libempathy-empathy-utils.html#empathy-xml-node-get-child-content">empathy_xml_node_get_child_content</a> (xmlNodePtr node,
68
const gchar *child_name);
69
xmlNodePtr <a class="link" href="libempathy-empathy-utils.html#empathy-xml-node-find-child-prop-value">empathy_xml_node_find_child_prop_value</a>
71
const gchar *prop_name,
72
const gchar *prop_value);
73
guint <a class="link" href="libempathy-empathy-utils.html#empathy-account-hash">empathy_account_hash</a> (gconstpointer key);
74
gboolean <a class="link" href="libempathy-empathy-utils.html#empathy-account-equal">empathy_account_equal</a> (gconstpointer a,
77
href="/usr/share/gtk-doc/html/libmissioncontrol/libmissioncontrol-mission-control.html#MissionControl"
78
>MissionControl</a>* <a class="link" href="libempathy-empathy-utils.html#empathy-mission-control-new">empathy_mission_control_new</a> (void);
79
gchar* <a class="link" href="libempathy-empathy-utils.html#empathy-inspect-handle">empathy_inspect_handle</a> (<a
80
href="/usr/share/gtk-doc/html/libmissioncontrol/McAccount.html"
81
>McAccount</a> *account,
84
gchar* <a class="link" href="libempathy-empathy-utils.html#empathy-inspect-channel">empathy_inspect_channel</a> (<a
85
href="/usr/share/gtk-doc/html/libmissioncontrol/McAccount.html"
86
>McAccount</a> *account,
88
void <a class="link" href="libempathy-empathy-utils.html#empathy-call-contact">empathy_call_contact</a> (<a class="link" href="EmpathyContact.html" title="EmpathyContact">EmpathyContact</a> *contact);
91
<div class="refsect1" lang="en">
92
<a name="id404132"></a><h2>Description</h2>
97
<div class="refsect1" lang="en">
98
<a name="id404148"></a><h2>Details</h2>
99
<div class="refsect2" lang="en">
100
<a name="id404158"></a><h3>
101
<a name="G-STR-EMPTY:CAPS"></a>G_STR_EMPTY()</h3>
102
<a class="indexterm" name="id404170"></a><pre class="programlisting">#define G_STR_EMPTY(x) ((x) == NULL || (x)[0] == '\0')
107
<div class="variablelist"><table border="0">
108
<col align="left" valign="top">
110
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
119
<div class="refsect2" lang="en">
120
<a name="id404204"></a><h3>
121
<a name="EmpathyRegExType"></a>enum EmpathyRegExType</h3>
122
<a class="indexterm" name="id404216"></a><pre class="programlisting">typedef enum {
124
EMPATHY_REGEX_BROWSER,
135
<div class="refsect2" lang="en">
136
<a name="id404233"></a><h3>
137
<a name="empathy-substring"></a>empathy_substring ()</h3>
138
<a class="indexterm" name="id404245"></a><pre class="programlisting">gchar* empathy_substring (const gchar *str,
144
<div class="variablelist"><table border="0">
145
<col align="left" valign="top">
148
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
153
<td><p><span class="term"><em class="parameter"><code>start</code></em> :</span></p></td>
158
<td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td>
163
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
173
<div class="refsect2" lang="en">
174
<a name="id407020"></a><h3>
175
<a name="empathy-regex-match"></a>empathy_regex_match ()</h3>
176
<a class="indexterm" name="id407031"></a><pre class="programlisting">gint empathy_regex_match (<a class="link" href="libempathy-empathy-utils.html#EmpathyRegExType">EmpathyRegExType</a> type,
183
<div class="variablelist"><table border="0">
184
<col align="left" valign="top">
187
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
192
<td><p><span class="term"><em class="parameter"><code>msg</code></em> :</span></p></td>
197
<td><p><span class="term"><em class="parameter"><code>start</code></em> :</span></p></td>
202
<td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td>
207
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
217
<div class="refsect2" lang="en">
218
<a name="id369272"></a><h3>
219
<a name="empathy-strcasecmp"></a>empathy_strcasecmp ()</h3>
220
<a class="indexterm" name="id363764"></a><pre class="programlisting">gint empathy_strcasecmp (const gchar *s1,
221
const gchar *s2);</pre>
225
<div class="variablelist"><table border="0">
226
<col align="left" valign="top">
229
<td><p><span class="term"><em class="parameter"><code>s1</code></em> :</span></p></td>
234
<td><p><span class="term"><em class="parameter"><code>s2</code></em> :</span></p></td>
239
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
249
<div class="refsect2" lang="en">
250
<a name="id407196"></a><h3>
251
<a name="empathy-strncasecmp"></a>empathy_strncasecmp ()</h3>
252
<a class="indexterm" name="id407206"></a><pre class="programlisting">gint empathy_strncasecmp (const gchar *s1,
258
<div class="variablelist"><table border="0">
259
<col align="left" valign="top">
262
<td><p><span class="term"><em class="parameter"><code>s1</code></em> :</span></p></td>
267
<td><p><span class="term"><em class="parameter"><code>s2</code></em> :</span></p></td>
272
<td><p><span class="term"><em class="parameter"><code>n</code></em> :</span></p></td>
277
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
287
<div class="refsect2" lang="en">
288
<a name="id407293"></a><h3>
289
<a name="empathy-xml-validate"></a>empathy_xml_validate ()</h3>
290
<a class="indexterm" name="id407304"></a><pre class="programlisting">gboolean empathy_xml_validate (xmlDoc *doc,
291
const gchar *dtd_filename);</pre>
295
<div class="variablelist"><table border="0">
296
<col align="left" valign="top">
299
<td><p><span class="term"><em class="parameter"><code>doc</code></em> :</span></p></td>
304
<td><p><span class="term"><em class="parameter"><code>dtd_filename</code></em> :</span></p></td>
309
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
319
<div class="refsect2" lang="en">
320
<a name="id407372"></a><h3>
321
<a name="empathy-xml-node-get-child"></a>empathy_xml_node_get_child ()</h3>
322
<a class="indexterm" name="id407382"></a><pre class="programlisting">xmlNodePtr empathy_xml_node_get_child (xmlNodePtr node,
323
const gchar *child_name);</pre>
327
<div class="variablelist"><table border="0">
328
<col align="left" valign="top">
331
<td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
336
<td><p><span class="term"><em class="parameter"><code>child_name</code></em> :</span></p></td>
341
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
351
<div class="refsect2" lang="en">
352
<a name="id407450"></a><h3>
353
<a name="empathy-xml-node-get-child-content"></a>empathy_xml_node_get_child_content ()</h3>
354
<a class="indexterm" name="id407460"></a><pre class="programlisting">xmlChar* empathy_xml_node_get_child_content (xmlNodePtr node,
355
const gchar *child_name);</pre>
359
<div class="variablelist"><table border="0">
360
<col align="left" valign="top">
363
<td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
368
<td><p><span class="term"><em class="parameter"><code>child_name</code></em> :</span></p></td>
373
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
383
<div class="refsect2" lang="en">
384
<a name="id407528"></a><h3>
385
<a name="empathy-xml-node-find-child-prop-value"></a>empathy_xml_node_find_child_prop_value ()</h3>
386
<a class="indexterm" name="id407539"></a><pre class="programlisting">xmlNodePtr empathy_xml_node_find_child_prop_value
388
const gchar *prop_name,
389
const gchar *prop_value);</pre>
393
<div class="variablelist"><table border="0">
394
<col align="left" valign="top">
397
<td><p><span class="term"><em class="parameter"><code>node</code></em> :</span></p></td>
402
<td><p><span class="term"><em class="parameter"><code>prop_name</code></em> :</span></p></td>
407
<td><p><span class="term"><em class="parameter"><code>prop_value</code></em> :</span></p></td>
412
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
422
<div class="refsect2" lang="en">
423
<a name="id407626"></a><h3>
424
<a name="empathy-account-hash"></a>empathy_account_hash ()</h3>
425
<a class="indexterm" name="id407637"></a><pre class="programlisting">guint empathy_account_hash (gconstpointer key);</pre>
429
<div class="variablelist"><table border="0">
430
<col align="left" valign="top">
433
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
438
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
448
<div class="refsect2" lang="en">
449
<a name="id407686"></a><h3>
450
<a name="empathy-account-equal"></a>empathy_account_equal ()</h3>
451
<a class="indexterm" name="id407696"></a><pre class="programlisting">gboolean empathy_account_equal (gconstpointer a,
452
gconstpointer b);</pre>
456
<div class="variablelist"><table border="0">
457
<col align="left" valign="top">
460
<td><p><span class="term"><em class="parameter"><code>a</code></em> :</span></p></td>
465
<td><p><span class="term"><em class="parameter"><code>b</code></em> :</span></p></td>
470
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
480
<div class="refsect2" lang="en">
481
<a name="id407764"></a><h3>
482
<a name="empathy-mission-control-new"></a>empathy_mission_control_new ()</h3>
483
<a class="indexterm" name="id407775"></a><pre class="programlisting"><a
484
href="/usr/share/gtk-doc/html/libmissioncontrol/libmissioncontrol-mission-control.html#MissionControl"
485
>MissionControl</a>* empathy_mission_control_new (void);</pre>
489
<div class="variablelist"><table border="0">
490
<col align="left" valign="top">
492
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
501
<div class="refsect2" lang="en">
502
<a name="id407806"></a><h3>
503
<a name="empathy-inspect-handle"></a>empathy_inspect_handle ()</h3>
504
<a class="indexterm" name="id407816"></a><pre class="programlisting">gchar* empathy_inspect_handle (<a
505
href="/usr/share/gtk-doc/html/libmissioncontrol/McAccount.html"
506
>McAccount</a> *account,
508
guint handle_type);</pre>
512
<div class="variablelist"><table border="0">
513
<col align="left" valign="top">
516
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
521
<td><p><span class="term"><em class="parameter"><code>handle</code></em> :</span></p></td>
526
<td><p><span class="term"><em class="parameter"><code>handle_type</code></em> :</span></p></td>
531
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
541
<div class="refsect2" lang="en">
542
<a name="id407903"></a><h3>
543
<a name="empathy-inspect-channel"></a>empathy_inspect_channel ()</h3>
544
<a class="indexterm" name="id407913"></a><pre class="programlisting">gchar* empathy_inspect_channel (<a
545
href="/usr/share/gtk-doc/html/libmissioncontrol/McAccount.html"
546
>McAccount</a> *account,
547
TpChan *tp_chan);</pre>
551
<div class="variablelist"><table border="0">
552
<col align="left" valign="top">
555
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
560
<td><p><span class="term"><em class="parameter"><code>tp_chan</code></em> :</span></p></td>
565
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
575
<div class="refsect2" lang="en">
576
<a name="id407981"></a><h3>
577
<a name="empathy-call-contact"></a>empathy_call_contact ()</h3>
578
<a class="indexterm" name="id407992"></a><pre class="programlisting">void empathy_call_contact (<a class="link" href="EmpathyContact.html" title="EmpathyContact">EmpathyContact</a> *contact);</pre>
582
<div class="variablelist"><table border="0">
583
<col align="left" valign="top">
585
<td><p><span class="term"><em class="parameter"><code>contact</code></em> :</span></p></td>
594
<div class="refsect1" lang="en">
595
<a name="id408032"></a><div class="refsect2" lang="en"><a name="id408033"></a></div>
597
<div class="refsect2" lang="en"><a name="id408034"></a></div>