← Back to branch summary

~ubuntu-branches/ubuntu/utopic/telepathy-glib/utopic

« back to all changes in this revision

Viewing changes to docs/reference/html/TpDynamicHandleRepo.html

  • Committer: Package Import Robot
  • Author(s): Simon McVittie
  • Date: 2014-09-16 15:49:50 UTC
  • mfrom: (60.1.5 sid)
  • Revision ID: package-import@ubuntu.com-20140916154950-krvowuvofhu8u6sp
Tags: 0.24.1-1
* New upstream stable release
* debian/copyright: clean up syntax (*.[ch] is unsupported),
  drop deleted files
* debian/watch: only match 0.x versions, 1.0 will be a separate
  source package

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/html/TpDynamicHandleRepo.html
2
2
<html>
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
 
<title>telepathy-glib API Reference Manual: TpDynamicHandleRepo</title>
 
5
<title>TpDynamicHandleRepo</title>
6
6
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7
7
<link rel="home" href="index.html" title="telepathy-glib API Reference Manual">
8
8
<link rel="up" href="ch-service-handles.html" title="Service-side handle repositories">
9
9
<link rel="prev" href="TpStaticHandleRepo.html" title="TpStaticHandleRepo">
10
10
<link rel="next" href="ch-utilities.html" title="Utilities">
11
 
<meta name="generator" content="GTK-Doc V1.20 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.19 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
 
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
 
<td width="100%" align="left" class="shortcuts">
17
 
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 
18
 
                  <a href="#TpDynamicHandleRepo.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 
19
 
                  <a href="#TpDynamicHandleRepo.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span> 
20
 
                  <a href="#TpDynamicHandleRepo.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span> 
21
 
                  <a href="#TpDynamicHandleRepo.properties" class="shortcut">Properties</a></span>
22
 
</td>
23
 
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
24
 
<td><a accesskey="u" href="ch-service-handles.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
25
 
<td><a accesskey="p" href="TpStaticHandleRepo.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
26
 
<td><a accesskey="n" href="ch-utilities.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
27
 
</tr></table>
 
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
 
16
<tr valign="middle">
 
17
<td><a accesskey="p" href="TpStaticHandleRepo.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
18
<td><a accesskey="u" href="ch-service-handles.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
 
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
 
20
<th width="100%" align="center">telepathy-glib API Reference Manual</th>
 
21
<td><a accesskey="n" href="ch-utilities.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
22
</tr>
 
23
<tr><td colspan="5" class="shortcuts">
 
24
<a href="#TpDynamicHandleRepo.synopsis" class="shortcut">Top</a>
 
25
                   | 
 
26
                  <a href="#TpDynamicHandleRepo.description" class="shortcut">Description</a>
 
27
                   | 
 
28
                  <a href="#TpDynamicHandleRepo.object-hierarchy" class="shortcut">Object Hierarchy</a>
 
29
                   | 
 
30
                  <a href="#TpDynamicHandleRepo.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
 
31
                   | 
 
32
                  <a href="#TpDynamicHandleRepo.properties" class="shortcut">Properties</a>
 
33
</td></tr>
 
34
</table>
28
35
<div class="refentry">
29
36
<a name="TpDynamicHandleRepo"></a><div class="titlepage"></div>
30
37
<div class="refnamediv"><table width="100%"><tr>
33
40
<p>TpDynamicHandleRepo — general handle repository implementation, with dynamic
34
41
 handle allocation and recycling</p>
35
42
</td>
36
 
<td class="gallery_image" valign="top" align="right"></td>
 
43
<td valign="top" align="right"></td>
37
44
</tr></table></div>
38
 
<div class="refsect1">
39
 
<a name="TpDynamicHandleRepo.functions"></a><h2>Functions</h2>
40
 
<div class="informaltable"><table width="100%" border="0">
41
 
<colgroup>
42
 
<col width="150px" class="functions_return">
43
 
<col class="functions_name">
44
 
</colgroup>
45
 
<tbody>
46
 
<tr>
47
 
<td class="function_type">
48
 
<a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="returnvalue">TpHandle</span></a>
49
 
</td>
50
 
<td class="function_name">
51
 
<a class="link" href="TpDynamicHandleRepo.html#tp-dynamic-handle-repo-lookup-exact" title="tp_dynamic_handle_repo_lookup_exact ()">tp_dynamic_handle_repo_lookup_exact</a> <span class="c_punctuation">()</span>
52
 
</td>
53
 
</tr>
54
 
<tr>
55
 
<td class="function_type">
56
 
<a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface"><span class="returnvalue">TpHandleRepoIface</span></a> *
57
 
</td>
58
 
<td class="function_name">
59
 
<a class="link" href="TpDynamicHandleRepo.html#tp-dynamic-handle-repo-new" title="tp_dynamic_handle_repo_new ()">tp_dynamic_handle_repo_new</a> <span class="c_punctuation">()</span>
60
 
</td>
61
 
</tr>
62
 
<tr>
63
 
<td class="function_type">
64
 
<span class="returnvalue">void</span>
65
 
</td>
66
 
<td class="function_name">
67
 
<a class="link" href="TpDynamicHandleRepo.html#tp-dynamic-handle-repo-set-normalize-async" title="tp_dynamic_handle_repo_set_normalize_async ()">tp_dynamic_handle_repo_set_normalize_async</a> <span class="c_punctuation">()</span>
68
 
</td>
69
 
</tr>
70
 
<tr>
71
 
<td class="function_type">
72
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
73
 
</td>
74
 
<td class="function_name">
75
 
<span class="c_punctuation">(</span><a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeFunc" title="TpDynamicHandleRepoNormalizeFunc ()">*TpDynamicHandleRepoNormalizeFunc</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
76
 
</td>
77
 
</tr>
78
 
<tr>
79
 
<td class="function_type">
80
 
<span class="returnvalue">void</span>
81
 
</td>
82
 
<td class="function_name">
83
 
<span class="c_punctuation">(</span><a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeAsync" title="TpDynamicHandleRepoNormalizeAsync ()">*TpDynamicHandleRepoNormalizeAsync</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
84
 
</td>
85
 
</tr>
86
 
<tr>
87
 
<td class="function_type">
88
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
89
 
</td>
90
 
<td class="function_name">
91
 
<span class="c_punctuation">(</span><a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeFinish" title="TpDynamicHandleRepoNormalizeFinish ()">*TpDynamicHandleRepoNormalizeFinish</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
92
 
</td>
93
 
</tr>
94
 
</tbody>
95
 
</table></div>
96
 
</div>
97
 
<div class="refsect1">
98
 
<a name="TpDynamicHandleRepo.properties"></a><h2>Properties</h2>
99
 
<div class="informaltable"><table border="0">
100
 
<colgroup>
101
 
<col width="150px" class="properties_type">
102
 
<col width="300px" class="properties_name">
103
 
<col width="200px" class="properties_flags">
104
 
</colgroup>
105
 
<tbody>
106
 
<tr>
107
 
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a></td>
108
 
<td class="property_name"><a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepo--default-normalize-context" title="The “default-normalize-context” property">default-normalize-context</a></td>
109
 
<td class="property_flags">Read / Write / Construct Only</td>
110
 
</tr>
111
 
<tr>
112
 
<td class="property_type"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a></td>
113
 
<td class="property_name"><a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepo--normalize-function" title="The “normalize-function” property">normalize-function</a></td>
114
 
<td class="property_flags">Read / Write / Construct Only</td>
115
 
</tr>
116
 
</tbody>
117
 
</table></div>
118
 
</div>
119
 
<div class="refsect1">
120
 
<a name="TpDynamicHandleRepo.other"></a><h2>Types and Values</h2>
121
 
<div class="informaltable"><table width="100%" border="0">
122
 
<colgroup>
123
 
<col width="150px" class="name">
124
 
<col class="description">
125
 
</colgroup>
126
 
<tbody>
127
 
<tr>
128
 
<td class="datatype_keyword"> </td>
129
 
<td class="function_name"><a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepo-struct" title="TpDynamicHandleRepo">TpDynamicHandleRepo</a></td>
130
 
</tr>
131
 
<tr>
132
 
<td class="datatype_keyword"> </td>
133
 
<td class="function_name"><a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoClass" title="TpDynamicHandleRepoClass">TpDynamicHandleRepoClass</a></td>
134
 
</tr>
135
 
</tbody>
136
 
</table></div>
 
45
<div class="refsynopsisdiv">
 
46
<a name="TpDynamicHandleRepo.synopsis"></a><h2>Synopsis</h2>
 
47
<pre class="synopsis">
 
48
#include &lt;telepathy-glib/telepathy-glib.h&gt;
 
49
 
 
50
                    <a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepo-struct" title="TpDynamicHandleRepo">TpDynamicHandleRepo</a>;
 
51
                    <a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoClass" title="TpDynamicHandleRepoClass">TpDynamicHandleRepoClass</a>;
 
52
<a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="returnvalue">TpHandle</span></a>            <a class="link" href="TpDynamicHandleRepo.html#tp-dynamic-handle-repo-lookup-exact" title="tp_dynamic_handle_repo_lookup_exact ()">tp_dynamic_handle_repo_lookup_exact</a> (<em class="parameter"><code><a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface"><span class="type">TpHandleRepoIface</span></a> *irepo</code></em>,
 
53
                                                         <em class="parameter"><code>const <span class="type">char</span> *id</code></em>);
 
54
<a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface"><span class="returnvalue">TpHandleRepoIface</span></a> * <a class="link" href="TpDynamicHandleRepo.html#tp-dynamic-handle-repo-new" title="tp_dynamic_handle_repo_new ()">tp_dynamic_handle_repo_new</a>          (<em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="type">TpHandleType</span></a> handle_type</code></em>,
 
55
                                                         <em class="parameter"><code><a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeFunc" title="TpDynamicHandleRepoNormalizeFunc ()"><span class="type">TpDynamicHandleRepoNormalizeFunc</span></a> normalize_func</code></em>,
 
56
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> default_normalize_context</code></em>);
 
57
<span class="returnvalue">void</span>                <a class="link" href="TpDynamicHandleRepo.html#tp-dynamic-handle-repo-set-normalize-async" title="tp_dynamic_handle_repo_set_normalize_async ()">tp_dynamic_handle_repo_set_normalize_async</a>
 
58
                                                        (<em class="parameter"><code><a class="link" href="TpDynamicHandleRepo.html" title="TpDynamicHandleRepo"><span class="type">TpDynamicHandleRepo</span></a> *self</code></em>,
 
59
                                                         <em class="parameter"><code><a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeAsync" title="TpDynamicHandleRepoNormalizeAsync ()"><span class="type">TpDynamicHandleRepoNormalizeAsync</span></a> normalize_async</code></em>,
 
60
                                                         <em class="parameter"><code><a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeFinish" title="TpDynamicHandleRepoNormalizeFinish ()"><span class="type">TpDynamicHandleRepoNormalizeFinish</span></a> normalize_finish</code></em>);
 
61
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             (<a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeFunc" title="TpDynamicHandleRepoNormalizeFunc ()">*TpDynamicHandleRepoNormalizeFunc</a>) (<em class="parameter"><code><a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface"><span class="type">TpHandleRepoIface</span></a> *repo</code></em>,
 
62
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
 
63
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> context</code></em>,
 
64
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 
65
<span class="returnvalue">void</span>                (<a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeAsync" title="TpDynamicHandleRepoNormalizeAsync ()">*TpDynamicHandleRepoNormalizeAsync</a>)
 
66
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface"><span class="type">TpHandleRepoIface</span></a> *repo</code></em>,
 
67
                                                         <em class="parameter"><code><a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a> *connection</code></em>,
 
68
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
 
69
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> context</code></em>,
 
70
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
 
71
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 
72
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             (<a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeFinish" title="TpDynamicHandleRepoNormalizeFinish ()">*TpDynamicHandleRepoNormalizeFinish</a>)
 
73
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface"><span class="type">TpHandleRepoIface</span></a> *repo</code></em>,
 
74
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
 
75
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 
76
</pre>
137
77
</div>
138
78
<div class="refsect1">
139
79
<a name="TpDynamicHandleRepo.object-hierarchy"></a><h2>Object Hierarchy</h2>
140
 
<pre class="screen">    <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
141
 
    <span class="lineart">╰──</span> TpDynamicHandleRepo
 
80
<pre class="synopsis">
 
81
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
82
   +----TpDynamicHandleRepo
142
83
</pre>
143
84
</div>
144
85
<div class="refsect1">
148
89
 <a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface">TpHandleRepoIface</a>.</p>
149
90
</div>
150
91
<div class="refsect1">
151
 
<a name="TpDynamicHandleRepo.includes"></a><h2>Includes</h2>
152
 
<pre class="synopsis">#include &lt;telepathy-glib/telepathy-glib.h&gt;
 
92
<a name="TpDynamicHandleRepo.properties"></a><h2>Properties</h2>
 
93
<pre class="synopsis">
 
94
  "<a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepo--default-normalize-context" title='The "default-normalize-context" property'>default-normalize-context</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Read / Write / Construct Only
 
95
  "<a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepo--normalize-function" title='The "normalize-function" property'>normalize-function</a>"       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Read / Write / Construct Only
153
96
</pre>
154
97
</div>
155
98
<div class="refsect1">
156
99
<a name="TpDynamicHandleRepo.description"></a><h2>Description</h2>
157
 
<p>A dynamic handle repository will accept arbitrary handles, which can
158
 
be created and destroyed at runtime.</p>
159
 
<p>The <a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface--handle-type" title="The “handle-type” property"><span class="type">“handle-type”</span></a> property must be set at construction
160
 
time; the <a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepo--normalize-function" title="The “normalize-function” property"><span class="type">“normalize-function”</span></a> property may be set to
161
 
perform validation and normalization on handle ID strings.</p>
162
 
<p>Most connection managers will use this for all supported handle types
163
 
except <a class="link" href="telepathy-glib-enums.html#TP-HANDLE-TYPE-LIST:CAPS"><code class="literal">TP_HANDLE_TYPE_LIST</code></a>.</p>
164
 
<p>Changed in 0.13.8: handles are no longer reference-counted, and
 
100
<p>
 
101
A dynamic handle repository will accept arbitrary handles, which can
 
102
be created and destroyed at runtime.
 
103
</p>
 
104
<p>
 
105
The <a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface--handle-type" title='The "handle-type" property'><span class="type">"handle-type"</span></a> property must be set at construction
 
106
time; the <a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepo--normalize-function" title='The "normalize-function" property'><span class="type">"normalize-function"</span></a> property may be set to
 
107
perform validation and normalization on handle ID strings.
 
108
</p>
 
109
<p>
 
110
Most connection managers will use this for all supported handle types
 
111
except <a class="link" href="telepathy-glib-enums.html#TP-HANDLE-TYPE-LIST:CAPS"><code class="literal">TP_HANDLE_TYPE_LIST</code></a>.
 
112
</p>
 
113
<p>
 
114
Changed in 0.13.8: handles are no longer reference-counted, and
165
115
the reference-count-related functions are stubs. Instead, handles remain
166
 
valid until the handle repository is destroyed.</p>
167
 
</div>
168
 
<div class="refsect1">
169
 
<a name="TpDynamicHandleRepo.functions_details"></a><h2>Functions</h2>
170
 
<div class="refsect2">
171
 
<a name="tp-dynamic-handle-repo-lookup-exact"></a><h3>tp_dynamic_handle_repo_lookup_exact ()</h3>
172
 
<pre class="programlisting"><a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="returnvalue">TpHandle</span></a>
173
 
tp_dynamic_handle_repo_lookup_exact (<em class="parameter"><code><a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface"><span class="type">TpHandleRepoIface</span></a> *irepo</code></em>,
174
 
                                     <em class="parameter"><code>const <span class="type">char</span> *id</code></em>);</pre>
175
 
<p>Look up a name in the repository, returning the corresponding handle if
176
 
it is present in the repository, without creating a new reference.</p>
177
 
<p>Unlike <a class="link" href="telepathy-glib-handle-repo.html#tp-handle-lookup" title="tp_handle_lookup ()"><code class="function">tp_handle_lookup()</code></a> this function does not perform any normalization;
178
 
it just looks for the literal string you requested. This can be useful to
179
 
call from normalization callbacks (for instance, Gabble's contacts
180
 
repository uses it to see whether we already know that a JID belongs
181
 
to a multi-user chat room member).</p>
182
 
<div class="refsect3">
183
 
<a name="id-1.7.4.10.2.6"></a><h4>Parameters</h4>
184
 
<div class="informaltable"><table width="100%" border="0">
185
 
<colgroup>
186
 
<col width="150px" class="parameters_name">
187
 
<col class="parameters_description">
188
 
<col width="200px" class="parameters_annotations">
189
 
</colgroup>
190
 
<tbody>
191
 
<tr>
192
 
<td class="parameter_name"><p>irepo</p></td>
193
 
<td class="parameter_description"><p>The handle repository</p></td>
194
 
<td class="parameter_annotations"> </td>
195
 
</tr>
196
 
<tr>
197
 
<td class="parameter_name"><p>id</p></td>
198
 
<td class="parameter_description"><p>The name to be looked up</p></td>
199
 
<td class="parameter_annotations"> </td>
200
 
</tr>
201
 
</tbody>
202
 
</table></div>
203
 
</div>
204
 
<div class="refsect3">
205
 
<a name="id-1.7.4.10.2.7"></a><h4>Returns</h4>
206
 
<p> the handle corresponding to the given ID, or 0 if not present</p>
207
 
<p></p>
208
 
</div>
209
 
</div>
210
 
<hr>
211
 
<div class="refsect2">
212
 
<a name="tp-dynamic-handle-repo-new"></a><h3>tp_dynamic_handle_repo_new ()</h3>
213
 
<pre class="programlisting"><a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface"><span class="returnvalue">TpHandleRepoIface</span></a> *
214
 
tp_dynamic_handle_repo_new (<em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="type">TpHandleType</span></a> handle_type</code></em>,
215
 
                            <em class="parameter"><code><a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeFunc" title="TpDynamicHandleRepoNormalizeFunc ()"><span class="type">TpDynamicHandleRepoNormalizeFunc</span></a> normalize_func</code></em>,
216
 
                            <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> default_normalize_context</code></em>);</pre>
217
 
<p></p>
218
 
<div class="refsect3">
219
 
<a name="id-1.7.4.10.3.5"></a><h4>Parameters</h4>
220
 
<div class="informaltable"><table width="100%" border="0">
221
 
<colgroup>
222
 
<col width="150px" class="parameters_name">
223
 
<col class="parameters_description">
224
 
<col width="200px" class="parameters_annotations">
225
 
</colgroup>
226
 
<tbody>
227
 
<tr>
228
 
<td class="parameter_name"><p>handle_type</p></td>
229
 
<td class="parameter_description"><p>The handle type</p></td>
230
 
<td class="parameter_annotations"> </td>
231
 
</tr>
232
 
<tr>
233
 
<td class="parameter_name"><p>normalize_func</p></td>
234
 
<td class="parameter_description"><p>The function to be used to normalize and validate handles,
235
 
or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to accept all handles as-is</p></td>
236
 
<td class="parameter_annotations"> </td>
237
 
</tr>
238
 
<tr>
239
 
<td class="parameter_name"><p>default_normalize_context</p></td>
240
 
<td class="parameter_description"><p>The context pointer to be passed to the
241
 
<em class="parameter"><code>normalize_func</code></em>
242
 
if a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> context is passed to <a class="link" href="telepathy-glib-handle-repo.html#tp-handle-lookup" title="tp_handle_lookup ()"><code class="function">tp_handle_lookup()</code></a> and
243
 
<a class="link" href="telepathy-glib-handle-repo.html#tp-handle-ensure" title="tp_handle_ensure ()"><code class="function">tp_handle_ensure()</code></a>; this may itself be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
244
 
<td class="parameter_annotations"> </td>
245
 
</tr>
246
 
</tbody>
247
 
</table></div>
248
 
</div>
249
 
<div class="refsect3">
250
 
<a name="id-1.7.4.10.3.6"></a><h4>Returns</h4>
251
 
<p> a new dynamic handle repository</p>
252
 
<p></p>
253
 
</div>
254
 
</div>
255
 
<hr>
256
 
<div class="refsect2">
257
 
<a name="tp-dynamic-handle-repo-set-normalize-async"></a><h3>tp_dynamic_handle_repo_set_normalize_async ()</h3>
258
 
<pre class="programlisting"><span class="returnvalue">void</span>
259
 
tp_dynamic_handle_repo_set_normalize_async
260
 
                               (<em class="parameter"><code><a class="link" href="TpDynamicHandleRepo.html" title="TpDynamicHandleRepo"><span class="type">TpDynamicHandleRepo</span></a> *self</code></em>,
261
 
                                <em class="parameter"><code><a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeAsync" title="TpDynamicHandleRepoNormalizeAsync ()"><span class="type">TpDynamicHandleRepoNormalizeAsync</span></a> normalize_async</code></em>,
262
 
                                <em class="parameter"><code><a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeFinish" title="TpDynamicHandleRepoNormalizeFinish ()"><span class="type">TpDynamicHandleRepoNormalizeFinish</span></a> normalize_finish</code></em>);</pre>
263
 
<p>Set an asynchronous normalization function. This is to be used if handle
264
 
normalization requires a server round-trip. See <a class="link" href="telepathy-glib-handle-repo.html#tp-handle-ensure-async" title="tp_handle_ensure_async ()"><code class="function">tp_handle_ensure_async()</code></a>.</p>
265
 
<div class="refsect3">
266
 
<a name="id-1.7.4.10.4.5"></a><h4>Parameters</h4>
267
 
<div class="informaltable"><table width="100%" border="0">
268
 
<colgroup>
269
 
<col width="150px" class="parameters_name">
270
 
<col class="parameters_description">
271
 
<col width="200px" class="parameters_annotations">
272
 
</colgroup>
273
 
<tbody>
274
 
<tr>
275
 
<td class="parameter_name"><p>self</p></td>
276
 
<td class="parameter_description"><p>A <a class="link" href="TpDynamicHandleRepo.html" title="TpDynamicHandleRepo"><span class="type">TpDynamicHandleRepo</span></a></p></td>
277
 
<td class="parameter_annotations"> </td>
278
 
</tr>
279
 
<tr>
280
 
<td class="parameter_name"><p>normalize_async</p></td>
281
 
<td class="parameter_description"><p>a <a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeAsync" title="TpDynamicHandleRepoNormalizeAsync ()"><span class="type">TpDynamicHandleRepoNormalizeAsync</span></a></p></td>
282
 
<td class="parameter_annotations"> </td>
283
 
</tr>
284
 
<tr>
285
 
<td class="parameter_name"><p>normalize_finish</p></td>
286
 
<td class="parameter_description"><p>a <a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeFinish" title="TpDynamicHandleRepoNormalizeFinish ()"><span class="type">TpDynamicHandleRepoNormalizeFinish</span></a></p></td>
287
 
<td class="parameter_annotations"> </td>
288
 
</tr>
289
 
</tbody>
290
 
</table></div>
291
 
</div>
292
 
<p class="since">Since 0.19.2</p>
293
 
</div>
294
 
<hr>
295
 
<div class="refsect2">
296
 
<a name="TpDynamicHandleRepoNormalizeFunc"></a><h3>TpDynamicHandleRepoNormalizeFunc ()</h3>
297
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
298
 
<span class="c_punctuation">(</span>*TpDynamicHandleRepoNormalizeFunc<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface"><span class="type">TpHandleRepoIface</span></a> *repo</code></em>,
299
 
                                     <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
300
 
                                     <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> context</code></em>,
301
 
                                     <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
302
 
<p>Signature of the normalization function optionally used by
303
 
<a class="link" href="TpDynamicHandleRepo.html" title="TpDynamicHandleRepo"><span class="type">TpDynamicHandleRepo</span></a> instances.</p>
304
 
<div class="refsect3">
305
 
<a name="id-1.7.4.10.5.5"></a><h4>Parameters</h4>
306
 
<div class="informaltable"><table width="100%" border="0">
307
 
<colgroup>
308
 
<col width="150px" class="parameters_name">
309
 
<col class="parameters_description">
310
 
<col width="200px" class="parameters_annotations">
311
 
</colgroup>
312
 
<tbody>
313
 
<tr>
314
 
<td class="parameter_name"><p>repo</p></td>
315
 
<td class="parameter_description"><p>The repository on which <a class="link" href="telepathy-glib-handle-repo.html#tp-handle-lookup" title="tp_handle_lookup ()"><code class="function">tp_handle_lookup()</code></a> or <a class="link" href="telepathy-glib-handle-repo.html#tp-handle-ensure" title="tp_handle_ensure ()"><code class="function">tp_handle_ensure()</code></a>
316
 
was called</p></td>
317
 
<td class="parameter_annotations"> </td>
318
 
</tr>
319
 
<tr>
320
 
<td class="parameter_name"><p>id</p></td>
321
 
<td class="parameter_description"><p>The name to be normalized</p></td>
322
 
<td class="parameter_annotations"> </td>
323
 
</tr>
324
 
<tr>
325
 
<td class="parameter_name"><p>context</p></td>
326
 
<td class="parameter_description"><p>Arbitrary context passed to <a class="link" href="telepathy-glib-handle-repo.html#tp-handle-lookup" title="tp_handle_lookup ()"><code class="function">tp_handle_lookup()</code></a> or
327
 
<a class="link" href="telepathy-glib-handle-repo.html#tp-handle-ensure" title="tp_handle_ensure ()"><code class="function">tp_handle_ensure()</code></a></p></td>
328
 
<td class="parameter_annotations"> </td>
329
 
</tr>
330
 
<tr>
331
 
<td class="parameter_name"><p>error</p></td>
332
 
<td class="parameter_description"><p>Used to raise the Telepathy error InvalidHandle with an appropriate
333
 
message if NULL is returned</p></td>
334
 
<td class="parameter_annotations"> </td>
335
 
</tr>
336
 
</tbody>
337
 
</table></div>
338
 
</div>
339
 
<div class="refsect3">
340
 
<a name="id-1.7.4.10.5.6"></a><h4>Returns</h4>
341
 
<p> a normalized version of <em class="parameter"><code>id</code></em>
342
 
(to be freed with g_free by the
343
 
caller), or NULL if <em class="parameter"><code>id</code></em>
344
 
is not valid for this repository</p>
345
 
<p></p>
346
 
</div>
347
 
</div>
348
 
<hr>
349
 
<div class="refsect2">
350
 
<a name="TpDynamicHandleRepoNormalizeAsync"></a><h3>TpDynamicHandleRepoNormalizeAsync ()</h3>
351
 
<pre class="programlisting"><span class="returnvalue">void</span>
352
 
<span class="c_punctuation">(</span>*TpDynamicHandleRepoNormalizeAsync<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface"><span class="type">TpHandleRepoIface</span></a> *repo</code></em>,
353
 
                                      <em class="parameter"><code><a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a> *connection</code></em>,
354
 
                                      <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
355
 
                                      <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> context</code></em>,
356
 
                                      <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
357
 
                                      <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
358
 
<p>Signature of a function to asynchronously normalize an identifier. See
359
 
<a class="link" href="TpDynamicHandleRepo.html#tp-dynamic-handle-repo-set-normalize-async" title="tp_dynamic_handle_repo_set_normalize_async ()"><code class="function">tp_dynamic_handle_repo_set_normalize_async()</code></a>.</p>
360
 
<div class="refsect3">
361
 
<a name="id-1.7.4.10.6.5"></a><h4>Parameters</h4>
362
 
<div class="informaltable"><table width="100%" border="0">
363
 
<colgroup>
364
 
<col width="150px" class="parameters_name">
365
 
<col class="parameters_description">
366
 
<col width="200px" class="parameters_annotations">
367
 
</colgroup>
368
 
<tbody>
369
 
<tr>
370
 
<td class="parameter_name"><p>repo</p></td>
371
 
<td class="parameter_description"><p>The repository on which <a class="link" href="telepathy-glib-handle-repo.html#tp-handle-ensure-async" title="tp_handle_ensure_async ()"><code class="function">tp_handle_ensure_async()</code></a> was called</p></td>
372
 
<td class="parameter_annotations"> </td>
373
 
</tr>
374
 
<tr>
375
 
<td class="parameter_name"><p>connection</p></td>
376
 
<td class="parameter_description"><p>the <a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a> using this handle repo</p></td>
377
 
<td class="parameter_annotations"> </td>
378
 
</tr>
379
 
<tr>
380
 
<td class="parameter_name"><p>id</p></td>
381
 
<td class="parameter_description"><p>The name to be normalized</p></td>
382
 
<td class="parameter_annotations"> </td>
383
 
</tr>
384
 
<tr>
385
 
<td class="parameter_name"><p>context</p></td>
386
 
<td class="parameter_description"><p>Arbitrary context passed to <a class="link" href="telepathy-glib-handle-repo.html#tp-handle-ensure-async" title="tp_handle_ensure_async ()"><code class="function">tp_handle_ensure_async()</code></a></p></td>
387
 
<td class="parameter_annotations"> </td>
388
 
</tr>
389
 
<tr>
390
 
<td class="parameter_name"><p>callback</p></td>
391
 
<td class="parameter_description"><p>a callback to call when the operation finishes</p></td>
392
 
<td class="parameter_annotations"> </td>
393
 
</tr>
394
 
<tr>
395
 
<td class="parameter_name"><p>user_data</p></td>
396
 
<td class="parameter_description"><p>data to pass to <em class="parameter"><code>callback</code></em>
397
 
</p></td>
398
 
<td class="parameter_annotations"> </td>
399
 
</tr>
400
 
</tbody>
401
 
</table></div>
402
 
</div>
403
 
<p class="since">Since 0.19.2</p>
404
 
</div>
405
 
<hr>
406
 
<div class="refsect2">
407
 
<a name="TpDynamicHandleRepoNormalizeFinish"></a><h3>TpDynamicHandleRepoNormalizeFinish ()</h3>
408
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
409
 
<span class="c_punctuation">(</span>*TpDynamicHandleRepoNormalizeFinish<span class="c_punctuation">)</span> (<em class="parameter"><code><a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface"><span class="type">TpHandleRepoIface</span></a> *repo</code></em>,
410
 
                                       <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
411
 
                                       <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
412
 
<p>Signature of a function to finish the operation started with
413
 
<a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeAsync" title="TpDynamicHandleRepoNormalizeAsync ()"><span class="type">TpDynamicHandleRepoNormalizeAsync</span></a>.</p>
414
 
<div class="refsect3">
415
 
<a name="id-1.7.4.10.7.5"></a><h4>Parameters</h4>
416
 
<div class="informaltable"><table width="100%" border="0">
417
 
<colgroup>
418
 
<col width="150px" class="parameters_name">
419
 
<col class="parameters_description">
420
 
<col width="200px" class="parameters_annotations">
421
 
</colgroup>
422
 
<tbody>
423
 
<tr>
424
 
<td class="parameter_name"><p>repo</p></td>
425
 
<td class="parameter_description"><p>The repository on which <a class="link" href="telepathy-glib-handle-repo.html#tp-handle-ensure-async" title="tp_handle_ensure_async ()"><code class="function">tp_handle_ensure_async()</code></a> was called</p></td>
426
 
<td class="parameter_annotations"> </td>
427
 
</tr>
428
 
<tr>
429
 
<td class="parameter_name"><p>result</p></td>
430
 
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a></p></td>
431
 
<td class="parameter_annotations"> </td>
432
 
</tr>
433
 
<tr>
434
 
<td class="parameter_name"><p>error</p></td>
435
 
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</p></td>
436
 
<td class="parameter_annotations"> </td>
437
 
</tr>
438
 
</tbody>
439
 
</table></div>
440
 
</div>
441
 
<p class="since">Since 0.19.2</p>
442
 
</div>
443
 
</div>
444
 
<div class="refsect1">
445
 
<a name="TpDynamicHandleRepo.other_details"></a><h2>Types and Values</h2>
 
116
valid until the handle repository is destroyed.
 
117
</p>
 
118
</div>
 
119
<div class="refsect1">
 
120
<a name="TpDynamicHandleRepo.details"></a><h2>Details</h2>
446
121
<div class="refsect2">
447
122
<a name="TpDynamicHandleRepo-struct"></a><h3>TpDynamicHandleRepo</h3>
448
123
<pre class="programlisting">typedef struct _TpDynamicHandleRepo TpDynamicHandleRepo;</pre>
449
 
<p>A dynamic handle repository. The contents of the struct are private.</p>
 
124
<p>
 
125
A dynamic handle repository. The contents of the struct are private.
 
126
</p>
450
127
</div>
451
128
<hr>
452
129
<div class="refsect2">
453
130
<a name="TpDynamicHandleRepoClass"></a><h3>TpDynamicHandleRepoClass</h3>
454
131
<pre class="programlisting">typedef struct _TpDynamicHandleRepoClass TpDynamicHandleRepoClass;</pre>
455
 
<p>The class of a dynamic handle repository. The contents of the struct
456
 
are private.</p>
 
132
<p>
 
133
The class of a dynamic handle repository. The contents of the struct
 
134
are private.
 
135
</p>
 
136
</div>
 
137
<hr>
 
138
<div class="refsect2">
 
139
<a name="tp-dynamic-handle-repo-lookup-exact"></a><h3>tp_dynamic_handle_repo_lookup_exact ()</h3>
 
140
<pre class="programlisting"><a class="link" href="telepathy-glib-handle.html#TpHandle" title="TpHandle"><span class="returnvalue">TpHandle</span></a>            tp_dynamic_handle_repo_lookup_exact (<em class="parameter"><code><a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface"><span class="type">TpHandleRepoIface</span></a> *irepo</code></em>,
 
141
                                                         <em class="parameter"><code>const <span class="type">char</span> *id</code></em>);</pre>
 
142
<p>
 
143
Look up a name in the repository, returning the corresponding handle if
 
144
it is present in the repository, without creating a new reference.
 
145
</p>
 
146
<p>
 
147
Unlike <a class="link" href="telepathy-glib-handle-repo.html#tp-handle-lookup" title="tp_handle_lookup ()"><code class="function">tp_handle_lookup()</code></a> this function does not perform any normalization;
 
148
it just looks for the literal string you requested. This can be useful to
 
149
call from normalization callbacks (for instance, Gabble's contacts
 
150
repository uses it to see whether we already know that a JID belongs
 
151
to a multi-user chat room member).
 
152
</p>
 
153
<div class="variablelist"><table border="0" class="variablelist">
 
154
<colgroup>
 
155
<col align="left" valign="top">
 
156
<col>
 
157
</colgroup>
 
158
<tbody>
 
159
<tr>
 
160
<td><p><span class="term"><em class="parameter"><code>irepo</code></em> :</span></p></td>
 
161
<td>The handle repository</td>
 
162
</tr>
 
163
<tr>
 
164
<td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
 
165
<td>The name to be looked up</td>
 
166
</tr>
 
167
<tr>
 
168
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
169
<td>the handle corresponding to the given ID, or 0 if not present</td>
 
170
</tr>
 
171
</tbody>
 
172
</table></div>
 
173
</div>
 
174
<hr>
 
175
<div class="refsect2">
 
176
<a name="tp-dynamic-handle-repo-new"></a><h3>tp_dynamic_handle_repo_new ()</h3>
 
177
<pre class="programlisting"><a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface"><span class="returnvalue">TpHandleRepoIface</span></a> * tp_dynamic_handle_repo_new          (<em class="parameter"><code><a class="link" href="telepathy-glib-enums.html#TpHandleType" title="enum TpHandleType"><span class="type">TpHandleType</span></a> handle_type</code></em>,
 
178
                                                         <em class="parameter"><code><a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeFunc" title="TpDynamicHandleRepoNormalizeFunc ()"><span class="type">TpDynamicHandleRepoNormalizeFunc</span></a> normalize_func</code></em>,
 
179
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> default_normalize_context</code></em>);</pre>
 
180
<p>
 
181
 
 
182
</p>
 
183
<div class="variablelist"><table border="0" class="variablelist">
 
184
<colgroup>
 
185
<col align="left" valign="top">
 
186
<col>
 
187
</colgroup>
 
188
<tbody>
 
189
<tr>
 
190
<td><p><span class="term"><em class="parameter"><code>handle_type</code></em> :</span></p></td>
 
191
<td>The handle type</td>
 
192
</tr>
 
193
<tr>
 
194
<td><p><span class="term"><em class="parameter"><code>normalize_func</code></em> :</span></p></td>
 
195
<td>The function to be used to normalize and validate handles,
 
196
or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to accept all handles as-is</td>
 
197
</tr>
 
198
<tr>
 
199
<td><p><span class="term"><em class="parameter"><code>default_normalize_context</code></em> :</span></p></td>
 
200
<td>The context pointer to be passed to the
 
201
<em class="parameter"><code>normalize_func</code></em> if a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> context is passed to <a class="link" href="telepathy-glib-handle-repo.html#tp-handle-lookup" title="tp_handle_lookup ()"><code class="function">tp_handle_lookup()</code></a> and
 
202
<a class="link" href="telepathy-glib-handle-repo.html#tp-handle-ensure" title="tp_handle_ensure ()"><code class="function">tp_handle_ensure()</code></a>; this may itself be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
203
</td>
 
204
</tr>
 
205
<tr>
 
206
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
207
<td>a new dynamic handle repository</td>
 
208
</tr>
 
209
</tbody>
 
210
</table></div>
 
211
</div>
 
212
<hr>
 
213
<div class="refsect2">
 
214
<a name="tp-dynamic-handle-repo-set-normalize-async"></a><h3>tp_dynamic_handle_repo_set_normalize_async ()</h3>
 
215
<pre class="programlisting"><span class="returnvalue">void</span>                tp_dynamic_handle_repo_set_normalize_async
 
216
                                                        (<em class="parameter"><code><a class="link" href="TpDynamicHandleRepo.html" title="TpDynamicHandleRepo"><span class="type">TpDynamicHandleRepo</span></a> *self</code></em>,
 
217
                                                         <em class="parameter"><code><a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeAsync" title="TpDynamicHandleRepoNormalizeAsync ()"><span class="type">TpDynamicHandleRepoNormalizeAsync</span></a> normalize_async</code></em>,
 
218
                                                         <em class="parameter"><code><a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeFinish" title="TpDynamicHandleRepoNormalizeFinish ()"><span class="type">TpDynamicHandleRepoNormalizeFinish</span></a> normalize_finish</code></em>);</pre>
 
219
<p>
 
220
Set an asynchronous normalization function. This is to be used if handle
 
221
normalization requires a server round-trip. See <a class="link" href="telepathy-glib-handle-repo.html#tp-handle-ensure-async" title="tp_handle_ensure_async ()"><code class="function">tp_handle_ensure_async()</code></a>.
 
222
</p>
 
223
<div class="variablelist"><table border="0" class="variablelist">
 
224
<colgroup>
 
225
<col align="left" valign="top">
 
226
<col>
 
227
</colgroup>
 
228
<tbody>
 
229
<tr>
 
230
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
 
231
<td>A <a class="link" href="TpDynamicHandleRepo.html" title="TpDynamicHandleRepo"><span class="type">TpDynamicHandleRepo</span></a>
 
232
</td>
 
233
</tr>
 
234
<tr>
 
235
<td><p><span class="term"><em class="parameter"><code>normalize_async</code></em> :</span></p></td>
 
236
<td>a <a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeAsync" title="TpDynamicHandleRepoNormalizeAsync ()"><span class="type">TpDynamicHandleRepoNormalizeAsync</span></a>
 
237
</td>
 
238
</tr>
 
239
<tr>
 
240
<td><p><span class="term"><em class="parameter"><code>normalize_finish</code></em> :</span></p></td>
 
241
<td>a <a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeFinish" title="TpDynamicHandleRepoNormalizeFinish ()"><span class="type">TpDynamicHandleRepoNormalizeFinish</span></a>
 
242
</td>
 
243
</tr>
 
244
</tbody>
 
245
</table></div>
 
246
<p class="since">Since 0.19.2</p>
 
247
</div>
 
248
<hr>
 
249
<div class="refsect2">
 
250
<a name="TpDynamicHandleRepoNormalizeFunc"></a><h3>TpDynamicHandleRepoNormalizeFunc ()</h3>
 
251
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             (*TpDynamicHandleRepoNormalizeFunc) (<em class="parameter"><code><a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface"><span class="type">TpHandleRepoIface</span></a> *repo</code></em>,
 
252
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
 
253
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> context</code></em>,
 
254
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 
255
<p>
 
256
Signature of the normalization function optionally used by
 
257
<a class="link" href="TpDynamicHandleRepo.html" title="TpDynamicHandleRepo"><span class="type">TpDynamicHandleRepo</span></a> instances.
 
258
</p>
 
259
<div class="variablelist"><table border="0" class="variablelist">
 
260
<colgroup>
 
261
<col align="left" valign="top">
 
262
<col>
 
263
</colgroup>
 
264
<tbody>
 
265
<tr>
 
266
<td><p><span class="term"><em class="parameter"><code>repo</code></em> :</span></p></td>
 
267
<td>The repository on which <a class="link" href="telepathy-glib-handle-repo.html#tp-handle-lookup" title="tp_handle_lookup ()"><code class="function">tp_handle_lookup()</code></a> or <a class="link" href="telepathy-glib-handle-repo.html#tp-handle-ensure" title="tp_handle_ensure ()"><code class="function">tp_handle_ensure()</code></a>
 
268
was called</td>
 
269
</tr>
 
270
<tr>
 
271
<td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
 
272
<td>The name to be normalized</td>
 
273
</tr>
 
274
<tr>
 
275
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
276
<td>Arbitrary context passed to <a class="link" href="telepathy-glib-handle-repo.html#tp-handle-lookup" title="tp_handle_lookup ()"><code class="function">tp_handle_lookup()</code></a> or
 
277
<a class="link" href="telepathy-glib-handle-repo.html#tp-handle-ensure" title="tp_handle_ensure ()"><code class="function">tp_handle_ensure()</code></a>
 
278
</td>
 
279
</tr>
 
280
<tr>
 
281
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 
282
<td>Used to raise the Telepathy error InvalidHandle with an appropriate
 
283
message if NULL is returned</td>
 
284
</tr>
 
285
<tr>
 
286
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
287
<td>a normalized version of <em class="parameter"><code>id</code></em> (to be freed with g_free by the
 
288
caller), or NULL if <em class="parameter"><code>id</code></em> is not valid for this repository</td>
 
289
</tr>
 
290
</tbody>
 
291
</table></div>
 
292
</div>
 
293
<hr>
 
294
<div class="refsect2">
 
295
<a name="TpDynamicHandleRepoNormalizeAsync"></a><h3>TpDynamicHandleRepoNormalizeAsync ()</h3>
 
296
<pre class="programlisting"><span class="returnvalue">void</span>                (*TpDynamicHandleRepoNormalizeAsync)
 
297
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface"><span class="type">TpHandleRepoIface</span></a> *repo</code></em>,
 
298
                                                         <em class="parameter"><code><a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a> *connection</code></em>,
 
299
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
 
300
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> context</code></em>,
 
301
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> callback</code></em>,
 
302
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 
303
<p>
 
304
Signature of a function to asynchronously normalize an identifier. See
 
305
<a class="link" href="TpDynamicHandleRepo.html#tp-dynamic-handle-repo-set-normalize-async" title="tp_dynamic_handle_repo_set_normalize_async ()"><code class="function">tp_dynamic_handle_repo_set_normalize_async()</code></a>.
 
306
</p>
 
307
<div class="variablelist"><table border="0" class="variablelist">
 
308
<colgroup>
 
309
<col align="left" valign="top">
 
310
<col>
 
311
</colgroup>
 
312
<tbody>
 
313
<tr>
 
314
<td><p><span class="term"><em class="parameter"><code>repo</code></em> :</span></p></td>
 
315
<td>The repository on which <a class="link" href="telepathy-glib-handle-repo.html#tp-handle-ensure-async" title="tp_handle_ensure_async ()"><code class="function">tp_handle_ensure_async()</code></a> was called</td>
 
316
</tr>
 
317
<tr>
 
318
<td><p><span class="term"><em class="parameter"><code>connection</code></em> :</span></p></td>
 
319
<td>the <a class="link" href="TpBaseConnection.html" title="TpBaseConnection"><span class="type">TpBaseConnection</span></a> using this handle repo</td>
 
320
</tr>
 
321
<tr>
 
322
<td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
 
323
<td>The name to be normalized</td>
 
324
</tr>
 
325
<tr>
 
326
<td><p><span class="term"><em class="parameter"><code>context</code></em> :</span></p></td>
 
327
<td>Arbitrary context passed to <a class="link" href="telepathy-glib-handle-repo.html#tp-handle-ensure-async" title="tp_handle_ensure_async ()"><code class="function">tp_handle_ensure_async()</code></a>
 
328
</td>
 
329
</tr>
 
330
<tr>
 
331
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
 
332
<td>a callback to call when the operation finishes</td>
 
333
</tr>
 
334
<tr>
 
335
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
336
<td>data to pass to <em class="parameter"><code>callback</code></em>
 
337
</td>
 
338
</tr>
 
339
</tbody>
 
340
</table></div>
 
341
<p class="since">Since 0.19.2</p>
 
342
</div>
 
343
<hr>
 
344
<div class="refsect2">
 
345
<a name="TpDynamicHandleRepoNormalizeFinish"></a><h3>TpDynamicHandleRepoNormalizeFinish ()</h3>
 
346
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             (*TpDynamicHandleRepoNormalizeFinish)
 
347
                                                        (<em class="parameter"><code><a class="link" href="telepathy-glib-handle-repo.html#TpHandleRepoIface"><span class="type">TpHandleRepoIface</span></a> *repo</code></em>,
 
348
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> *result</code></em>,
 
349
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 
350
<p>
 
351
Signature of a function to finish the operation started with
 
352
<a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeAsync" title="TpDynamicHandleRepoNormalizeAsync ()"><span class="type">TpDynamicHandleRepoNormalizeAsync</span></a>.
 
353
</p>
 
354
<div class="variablelist"><table border="0" class="variablelist">
 
355
<colgroup>
 
356
<col align="left" valign="top">
 
357
<col>
 
358
</colgroup>
 
359
<tbody>
 
360
<tr>
 
361
<td><p><span class="term"><em class="parameter"><code>repo</code></em> :</span></p></td>
 
362
<td>The repository on which <a class="link" href="telepathy-glib-handle-repo.html#tp-handle-ensure-async" title="tp_handle_ensure_async ()"><code class="function">tp_handle_ensure_async()</code></a> was called</td>
 
363
</tr>
 
364
<tr>
 
365
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
 
366
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a>
 
367
</td>
 
368
</tr>
 
369
<tr>
 
370
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 
371
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> to fill</td>
 
372
</tr>
 
373
</tbody>
 
374
</table></div>
 
375
<p class="since">Since 0.19.2</p>
457
376
</div>
458
377
</div>
459
378
<div class="refsect1">
460
379
<a name="TpDynamicHandleRepo.property-details"></a><h2>Property Details</h2>
461
380
<div class="refsect2">
462
 
<a name="TpDynamicHandleRepo--default-normalize-context"></a><h3>The <code class="literal">“default-normalize-context”</code> property</h3>
463
 
<pre class="programlisting">  “default-normalize-context” <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a></pre>
464
 
<p>An optional default context given to the
465
 
<a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepo--normalize-function" title="The “normalize-function” property"><span class="type">“normalize-function”</span></a> if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is passed as context to
 
381
<a name="TpDynamicHandleRepo--default-normalize-context"></a><h3>The <code class="literal">"default-normalize-context"</code> property</h3>
 
382
<pre class="programlisting">  "default-normalize-context" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Read / Write / Construct Only</pre>
 
383
<p>
 
384
An optional default context given to the
 
385
<a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepo--normalize-function" title='The "normalize-function" property'><span class="type">"normalize-function"</span></a> if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is passed as context to
466
386
the ensure or lookup functions, e.g. when RequestHandle is called via
467
 
D-Bus. The default is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
468
 
<p>Flags: Read / Write / Construct Only</p>
 
387
D-Bus. The default is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 
388
</p>
469
389
</div>
470
390
<hr>
471
391
<div class="refsect2">
472
 
<a name="TpDynamicHandleRepo--normalize-function"></a><h3>The <code class="literal">“normalize-function”</code> property</h3>
473
 
<pre class="programlisting">  “normalize-function”       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a></pre>
474
 
<p>An optional <a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeFunc" title="TpDynamicHandleRepoNormalizeFunc ()"><span class="type">TpDynamicHandleRepoNormalizeFunc</span></a> used to validate and
 
392
<a name="TpDynamicHandleRepo--normalize-function"></a><h3>The <code class="literal">"normalize-function"</code> property</h3>
 
393
<pre class="programlisting">  "normalize-function"       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>              : Read / Write / Construct Only</pre>
 
394
<p>
 
395
An optional <a class="link" href="TpDynamicHandleRepo.html#TpDynamicHandleRepoNormalizeFunc" title="TpDynamicHandleRepoNormalizeFunc ()"><span class="type">TpDynamicHandleRepoNormalizeFunc</span></a> used to validate and
475
396
normalize handle IDs. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> (which is the default), any handle ID is
476
397
accepted as-is (equivalent to supplying a pointer to a function that just
477
 
calls g_strdup).</p>
478
 
<p>Flags: Read / Write / Construct Only</p>
 
398
calls g_strdup).
 
399
</p>
479
400
</div>
480
401
</div>
481
402
<div class="refsect1">
482
403
<a name="TpDynamicHandleRepo.see-also"></a><h2>See Also</h2>
483
 
<p>TpHandleRepoIface, TpStaticHandleRepo</p>
 
404
TpHandleRepoIface, TpStaticHandleRepo
484
405
</div>
485
406
</div>
486
407
<div class="footer">
487
408
<hr>
488
 
          Generated by GTK-Doc V1.20</div>
 
409
          Generated by GTK-Doc V1.19</div>
489
410
</body>
490
411
</html>
 
 
b'\\ No newline at end of file'