~ubuntu-branches/ubuntu/quantal/telepathy-logger/quantal

« back to all changes in this revision

Viewing changes to doc/reference/libtelepathy-logger/html/TplLogManager.html

  • Committer: Bazaar Package Importer
  • Author(s): Jonny Lamb
  • Date: 2011-06-07 10:26:37 UTC
  • mfrom: (1.1.13 upstream)
  • Revision ID: james.westby@ubuntu.com-20110607102637-sdd04hsk1g099oyr
Tags: 0.2.10-1
* New upstream release.
* debian/libtelepathy-logger2.symbols: Updated for new release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
 
<html>
3
 
<head>
4
 
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
 
<title>TplLogManager</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7
 
<link rel="home" href="index.html" title="telepathy-logger Reference Manual">
8
 
<link rel="up" href="ch-public.html" title="libtelepathy-logger API">
9
 
<link rel="prev" href="ch-public.html" title="libtelepathy-logger API">
10
 
<link rel="next" href="TplEvent.html" title="TplEvent">
11
 
<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
12
 
<link rel="stylesheet" href="style.css" type="text/css">
13
 
</head>
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="2">
16
 
<tr valign="middle">
17
 
<td><a accesskey="p" href="ch-public.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
 
<td><a accesskey="u" href="ch-public.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-logger Reference Manual</th>
21
 
<td><a accesskey="n" href="TplEvent.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="#TplLogManager.synopsis" class="shortcut">Top</a>
25
 
                   | 
26
 
                  <a href="#TplLogManager.description" class="shortcut">Description</a>
27
 
                   | 
28
 
                  <a href="#TplLogManager.object-hierarchy" class="shortcut">Object Hierarchy</a>
29
 
</td></tr>
30
 
</table>
31
 
<div class="refentry" title="TplLogManager">
32
 
<a name="TplLogManager"></a><div class="titlepage"></div>
33
 
<div class="refnamediv"><table width="100%"><tr>
34
 
<td valign="top">
35
 
<h2><span class="refentrytitle"><a name="TplLogManager.top_of_page"></a>TplLogManager</span></h2>
36
 
<p>TplLogManager — Fetch and search through logs</p>
37
 
</td>
38
 
<td valign="top" align="right"></td>
39
 
</tr></table></div>
40
 
<div class="refsynopsisdiv" title="Synopsis">
41
 
<a name="TplLogManager.synopsis"></a><h2>Synopsis</h2>
42
 
<pre class="synopsis">#define             <a class="link" href="TplLogManager.html#TPL-LOG-MANAGER-ERROR:CAPS" title="TPL_LOG_MANAGER_ERROR">TPL_LOG_MANAGER_ERROR</a>
43
 
<span class="returnvalue">GQuark</span>              <a class="link" href="TplLogManager.html#tpl-log-manager-errors-quark" title="tpl_log_manager_errors_quark ()">tpl_log_manager_errors_quark</a>        (<em class="parameter"><code><span class="type">void</span></code></em>);
44
 
enum                <a class="link" href="TplLogManager.html#TplLogManagerError" title="enum TplLogManagerError">TplLogManagerError</a>;
45
 
                    <a class="link" href="TplLogManager.html#TplLogManager-struct" title="TplLogManager">TplLogManager</a>;
46
 
enum                <a class="link" href="TplLogManager.html#TplEventTypeMask" title="enum TplEventTypeMask">TplEventTypeMask</a>;
47
 
<span class="returnvalue">gboolean</span>            (<a class="link" href="TplLogManager.html#TplLogEventFilter" title="TplLogEventFilter ()">*TplLogEventFilter</a>)                (<em class="parameter"><code><a class="link" href="TplEvent.html" title="TplEvent"><span class="type">TplEvent</span></a> *event</code></em>,
48
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);
49
 
<a class="link" href="TplLogManager.html" title="TplLogManager"><span class="returnvalue">TplLogManager</span></a> *     <a class="link" href="TplLogManager.html#tpl-log-manager-dup-singleton" title="tpl_log_manager_dup_singleton ()">tpl_log_manager_dup_singleton</a>       (<em class="parameter"><code><span class="type">void</span></code></em>);
50
 
<span class="returnvalue">gboolean</span>            <a class="link" href="TplLogManager.html#tpl-log-manager-exists" title="tpl_log_manager_exists ()">tpl_log_manager_exists</a>              (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *manager</code></em>,
51
 
                                                         <em class="parameter"><code><a href="http://telepathy.freedesktop.org/doc/telepathy-glib/telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
52
 
                                                         <em class="parameter"><code><a class="link" href="TplEntity.html" title="TplEntity"><span class="type">TplEntity</span></a> *target</code></em>,
53
 
                                                         <em class="parameter"><code><span class="type">gint</span> type_mask</code></em>);
54
 
<span class="returnvalue">void</span>                <a class="link" href="TplLogManager.html#tpl-log-manager-get-dates-async" title="tpl_log_manager_get_dates_async ()">tpl_log_manager_get_dates_async</a>     (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *manager</code></em>,
55
 
                                                         <em class="parameter"><code><a href="http://telepathy.freedesktop.org/doc/telepathy-glib/telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
56
 
                                                         <em class="parameter"><code><a class="link" href="TplEntity.html" title="TplEntity"><span class="type">TplEntity</span></a> *target</code></em>,
57
 
                                                         <em class="parameter"><code><span class="type">gint</span> type_mask</code></em>,
58
 
                                                         <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
59
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);
60
 
<span class="returnvalue">gboolean</span>            <a class="link" href="TplLogManager.html#tpl-log-manager-get-dates-finish" title="tpl_log_manager_get_dates_finish ()">tpl_log_manager_get_dates_finish</a>    (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *self</code></em>,
61
 
                                                         <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
62
 
                                                         <em class="parameter"><code><span class="type">GList</span> **dates</code></em>,
63
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
64
 
<span class="returnvalue">void</span>                <a class="link" href="TplLogManager.html#tpl-log-manager-get-events-for-date-async" title="tpl_log_manager_get_events_for_date_async ()">tpl_log_manager_get_events_for_date_async</a>
65
 
                                                        (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *manager</code></em>,
66
 
                                                         <em class="parameter"><code><a href="http://telepathy.freedesktop.org/doc/telepathy-glib/telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
67
 
                                                         <em class="parameter"><code><a class="link" href="TplEntity.html" title="TplEntity"><span class="type">TplEntity</span></a> *target</code></em>,
68
 
                                                         <em class="parameter"><code><span class="type">gint</span> type_mask</code></em>,
69
 
                                                         <em class="parameter"><code>const <span class="type">GDate</span> *date</code></em>,
70
 
                                                         <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
71
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);
72
 
<span class="returnvalue">gboolean</span>            <a class="link" href="TplLogManager.html#tpl-log-manager-get-events-for-date-finish" title="tpl_log_manager_get_events_for_date_finish ()">tpl_log_manager_get_events_for_date_finish</a>
73
 
                                                        (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *self</code></em>,
74
 
                                                         <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
75
 
                                                         <em class="parameter"><code><span class="type">GList</span> **events</code></em>,
76
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
77
 
<span class="returnvalue">void</span>                <a class="link" href="TplLogManager.html#tpl-log-manager-get-filtered-events-async" title="tpl_log_manager_get_filtered_events_async ()">tpl_log_manager_get_filtered_events_async</a>
78
 
                                                        (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *manager</code></em>,
79
 
                                                         <em class="parameter"><code><a href="http://telepathy.freedesktop.org/doc/telepathy-glib/telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
80
 
                                                         <em class="parameter"><code><a class="link" href="TplEntity.html" title="TplEntity"><span class="type">TplEntity</span></a> *target</code></em>,
81
 
                                                         <em class="parameter"><code><span class="type">gint</span> type_mask</code></em>,
82
 
                                                         <em class="parameter"><code><span class="type">guint</span> num_events</code></em>,
83
 
                                                         <em class="parameter"><code><a class="link" href="TplLogManager.html#TplLogEventFilter" title="TplLogEventFilter ()"><span class="type">TplLogEventFilter</span></a> filter</code></em>,
84
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> filter_user_data</code></em>,
85
 
                                                         <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
86
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);
87
 
<span class="returnvalue">gboolean</span>            <a class="link" href="TplLogManager.html#tpl-log-manager-get-filtered-events-finish" title="tpl_log_manager_get_filtered_events_finish ()">tpl_log_manager_get_filtered_events_finish</a>
88
 
                                                        (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *self</code></em>,
89
 
                                                         <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
90
 
                                                         <em class="parameter"><code><span class="type">GList</span> **events</code></em>,
91
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
92
 
<span class="returnvalue">void</span>                <a class="link" href="TplLogManager.html#tpl-log-manager-get-entities-async" title="tpl_log_manager_get_entities_async ()">tpl_log_manager_get_entities_async</a>  (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *self</code></em>,
93
 
                                                         <em class="parameter"><code><a href="http://telepathy.freedesktop.org/doc/telepathy-glib/telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
94
 
                                                         <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
95
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);
96
 
<span class="returnvalue">gboolean</span>            <a class="link" href="TplLogManager.html#tpl-log-manager-get-entities-finish" title="tpl_log_manager_get_entities_finish ()">tpl_log_manager_get_entities_finish</a> (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *self</code></em>,
97
 
                                                         <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
98
 
                                                         <em class="parameter"><code><span class="type">GList</span> **entities</code></em>,
99
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
100
 
<span class="returnvalue">void</span>                <a class="link" href="TplLogManager.html#tpl-log-manager-search-async" title="tpl_log_manager_search_async ()">tpl_log_manager_search_async</a>        (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *manager</code></em>,
101
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
102
 
                                                         <em class="parameter"><code><span class="type">gint</span> type_mask</code></em>,
103
 
                                                         <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
104
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);
105
 
<span class="returnvalue">gboolean</span>            <a class="link" href="TplLogManager.html#tpl-log-manager-search-finish" title="tpl_log_manager_search_finish ()">tpl_log_manager_search_finish</a>       (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *self</code></em>,
106
 
                                                         <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
107
 
                                                         <em class="parameter"><code><span class="type">GList</span> **hits</code></em>,
108
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
109
 
<span class="returnvalue">void</span>                <a class="link" href="TplLogManager.html#tpl-log-manager-search-free" title="tpl_log_manager_search_free ()">tpl_log_manager_search_free</a>         (<em class="parameter"><code><span class="type">GList</span> *hits</code></em>);
110
 
</pre>
111
 
</div>
112
 
<div class="refsect1" title="Object Hierarchy">
113
 
<a name="TplLogManager.object-hierarchy"></a><h2>Object Hierarchy</h2>
114
 
<pre class="synopsis">
115
 
  GObject
116
 
   +----TplLogManager
117
 
</pre>
118
 
</div>
119
 
<div class="refsect1" title="Description">
120
 
<a name="TplLogManager.description"></a><h2>Description</h2>
121
 
<p>
122
 
The <a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> object allows user to fetch logs and make searches.
123
 
</p>
124
 
</div>
125
 
<div class="refsect1" title="Details">
126
 
<a name="TplLogManager.details"></a><h2>Details</h2>
127
 
<div class="refsect2" title="TPL_LOG_MANAGER_ERROR">
128
 
<a name="TPL-LOG-MANAGER-ERROR:CAPS"></a><h3>TPL_LOG_MANAGER_ERROR</h3>
129
 
<pre class="programlisting">#define TPL_LOG_MANAGER_ERROR tpl_log_manager_errors_quark()
130
 
</pre>
131
 
<p>
132
 
The error domain for the <a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a>.
133
 
</p>
134
 
</div>
135
 
<hr>
136
 
<div class="refsect2" title="tpl_log_manager_errors_quark ()">
137
 
<a name="tpl-log-manager-errors-quark"></a><h3>tpl_log_manager_errors_quark ()</h3>
138
 
<pre class="programlisting"><span class="returnvalue">GQuark</span>              tpl_log_manager_errors_quark        (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
139
 
<div class="variablelist"><table border="0">
140
 
<col align="left" valign="top">
141
 
<tbody><tr>
142
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
143
 
<td> the <span class="type">GQuark</span> associated with the error domain of <a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a>
144
 
</td>
145
 
</tr></tbody>
146
 
</table></div>
147
 
</div>
148
 
<hr>
149
 
<div class="refsect2" title="enum TplLogManagerError">
150
 
<a name="TplLogManagerError"></a><h3>enum TplLogManagerError</h3>
151
 
<pre class="programlisting">typedef enum
152
 
{
153
 
  TPL_LOG_MANAGER_ERROR_ADD_EVENT
154
 
} TplLogManagerError;
155
 
</pre>
156
 
<div class="variablelist"><table border="0">
157
 
<col align="left" valign="top">
158
 
<tbody><tr>
159
 
<td><p><a name="TPL-LOG-MANAGER-ERROR-ADD-EVENT:CAPS"></a><span class="term"><code class="literal">TPL_LOG_MANAGER_ERROR_ADD_EVENT</code></span></p></td>
160
 
<td>Error return when adding logs fails
161
 
</td>
162
 
</tr></tbody>
163
 
</table></div>
164
 
</div>
165
 
<hr>
166
 
<div class="refsect2" title="TplLogManager">
167
 
<a name="TplLogManager-struct"></a><h3>TplLogManager</h3>
168
 
<pre class="programlisting">typedef struct _TplLogManager TplLogManager;</pre>
169
 
<p>
170
 
An object used to access logs
171
 
</p>
172
 
</div>
173
 
<hr>
174
 
<div class="refsect2" title="enum TplEventTypeMask">
175
 
<a name="TplEventTypeMask"></a><h3>enum TplEventTypeMask</h3>
176
 
<pre class="programlisting">typedef enum
177
 
{
178
 
  TPL_EVENT_MASK_TEXT         = 1 &lt;&lt; 0,
179
 
  TPL_EVENT_MASK_CALL         = 1 &lt;&lt; 1,
180
 
  TPL_EVENT_MASK_ANY          = 0xffff
181
 
} TplEventTypeMask;
182
 
</pre>
183
 
<p>
184
 
Mask used to filter type of <a class="link" href="TplEvent.html" title="TplEvent"><span class="type">TplEvent</span></a> returned.
185
 
</p>
186
 
<div class="variablelist"><table border="0">
187
 
<col align="left" valign="top">
188
 
<tbody>
189
 
<tr>
190
 
<td><p><a name="TPL-EVENT-MASK-TEXT:CAPS"></a><span class="term"><code class="literal">TPL_EVENT_MASK_TEXT</code></span></p></td>
191
 
<td>Mask to <a class="link" href="TplTextEvent.html" title="TplTextEvent"><span class="type">TplTextEvent</span></a>
192
 
</td>
193
 
</tr>
194
 
<tr>
195
 
<td><p><a name="TPL-EVENT-MASK-CALL:CAPS"></a><span class="term"><code class="literal">TPL_EVENT_MASK_CALL</code></span></p></td>
196
 
<td>
197
 
</td>
198
 
</tr>
199
 
<tr>
200
 
<td><p><a name="TPL-EVENT-MASK-ANY:CAPS"></a><span class="term"><code class="literal">TPL_EVENT_MASK_ANY</code></span></p></td>
201
 
<td>Special value to select all type of <a class="link" href="TplEvent.html" title="TplEvent"><span class="type">TplEvent</span></a>
202
 
</td>
203
 
</tr>
204
 
</tbody>
205
 
</table></div>
206
 
</div>
207
 
<hr>
208
 
<div class="refsect2" title="TplLogEventFilter ()">
209
 
<a name="TplLogEventFilter"></a><h3>TplLogEventFilter ()</h3>
210
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            (*TplLogEventFilter)                (<em class="parameter"><code><a class="link" href="TplEvent.html" title="TplEvent"><span class="type">TplEvent</span></a> *event</code></em>,
211
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
212
 
<div class="variablelist"><table border="0">
213
 
<col align="left" valign="top">
214
 
<tbody>
215
 
<tr>
216
 
<td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td>
217
 
<td>the <a class="link" href="TplEvent.html" title="TplEvent"><span class="type">TplEvent</span></a> to filter
218
 
</td>
219
 
</tr>
220
 
<tr>
221
 
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
222
 
<td>user-supplied data
223
 
</td>
224
 
</tr>
225
 
<tr>
226
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
227
 
<td> <code class="literal">TRUE</code> if <em class="parameter"><code>event</code></em> should appear in the result
228
 
</td>
229
 
</tr>
230
 
</tbody>
231
 
</table></div>
232
 
</div>
233
 
<hr>
234
 
<div class="refsect2" title="tpl_log_manager_dup_singleton ()">
235
 
<a name="tpl-log-manager-dup-singleton"></a><h3>tpl_log_manager_dup_singleton ()</h3>
236
 
<pre class="programlisting"><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="returnvalue">TplLogManager</span></a> *     tpl_log_manager_dup_singleton       (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
237
 
<div class="variablelist"><table border="0">
238
 
<col align="left" valign="top">
239
 
<tbody><tr>
240
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
241
 
<td> a new reference on the log manager. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
242
 
</td>
243
 
</tr></tbody>
244
 
</table></div>
245
 
</div>
246
 
<hr>
247
 
<div class="refsect2" title="tpl_log_manager_exists ()">
248
 
<a name="tpl-log-manager-exists"></a><h3>tpl_log_manager_exists ()</h3>
249
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            tpl_log_manager_exists              (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *manager</code></em>,
250
 
                                                         <em class="parameter"><code><a href="http://telepathy.freedesktop.org/doc/telepathy-glib/telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
251
 
                                                         <em class="parameter"><code><a class="link" href="TplEntity.html" title="TplEntity"><span class="type">TplEntity</span></a> *target</code></em>,
252
 
                                                         <em class="parameter"><code><span class="type">gint</span> type_mask</code></em>);</pre>
253
 
<p>
254
 
Checks if logs exist for <em class="parameter"><code>target</code></em>.
255
 
</p>
256
 
<p>
257
 
It applies for any registered TplLogStore with the <span class="type">"readable"</span>
258
 
property <code class="literal">TRUE</code>.
259
 
</p>
260
 
<div class="variablelist"><table border="0">
261
 
<col align="left" valign="top">
262
 
<tbody>
263
 
<tr>
264
 
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
265
 
<td>TplLogManager
266
 
</td>
267
 
</tr>
268
 
<tr>
269
 
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
270
 
<td>TpAccount
271
 
</td>
272
 
</tr>
273
 
<tr>
274
 
<td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
275
 
<td>a non-NULL <a class="link" href="TplEntity.html" title="TplEntity"><span class="type">TplEntity</span></a>
276
 
</td>
277
 
</tr>
278
 
<tr>
279
 
<td><p><span class="term"><em class="parameter"><code>type_mask</code></em> :</span></p></td>
280
 
<td>event type filter see <a class="link" href="TplLogManager.html#TplEventTypeMask" title="enum TplEventTypeMask"><span class="type">TplEventTypeMask</span></a>
281
 
</td>
282
 
</tr>
283
 
<tr>
284
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
285
 
<td> <code class="literal">TRUE</code> logs exist for <em class="parameter"><code>target</code></em>, otherwise <code class="literal">FALSE</code>
286
 
</td>
287
 
</tr>
288
 
</tbody>
289
 
</table></div>
290
 
</div>
291
 
<hr>
292
 
<div class="refsect2" title="tpl_log_manager_get_dates_async ()">
293
 
<a name="tpl-log-manager-get-dates-async"></a><h3>tpl_log_manager_get_dates_async ()</h3>
294
 
<pre class="programlisting"><span class="returnvalue">void</span>                tpl_log_manager_get_dates_async     (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *manager</code></em>,
295
 
                                                         <em class="parameter"><code><a href="http://telepathy.freedesktop.org/doc/telepathy-glib/telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
296
 
                                                         <em class="parameter"><code><a class="link" href="TplEntity.html" title="TplEntity"><span class="type">TplEntity</span></a> *target</code></em>,
297
 
                                                         <em class="parameter"><code><span class="type">gint</span> type_mask</code></em>,
298
 
                                                         <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
299
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
300
 
<p>
301
 
Retrieves a list of <span class="type">GDate</span> corresponding to each day where
302
 
at least one event exist for <em class="parameter"><code>target</code></em>.
303
 
</p>
304
 
<p>
305
 
It applies for any registered TplLogStore with the <span class="type">"readable"</span>
306
 
property <code class="literal">TRUE</code>.
307
 
</p>
308
 
<div class="variablelist"><table border="0">
309
 
<col align="left" valign="top">
310
 
<tbody>
311
 
<tr>
312
 
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
313
 
<td>a <a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a>
314
 
</td>
315
 
</tr>
316
 
<tr>
317
 
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
318
 
<td>a <a href="http://telepathy.freedesktop.org/doc/telepathy-glib/telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
319
 
</td>
320
 
</tr>
321
 
<tr>
322
 
<td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
323
 
<td>a non-NULL <a class="link" href="TplEntity.html" title="TplEntity"><span class="type">TplEntity</span></a>
324
 
</td>
325
 
</tr>
326
 
<tr>
327
 
<td><p><span class="term"><em class="parameter"><code>type_mask</code></em> :</span></p></td>
328
 
<td>event type filter see <a class="link" href="TplLogManager.html#TplEventTypeMask" title="enum TplEventTypeMask"><span class="type">TplEventTypeMask</span></a>
329
 
</td>
330
 
</tr>
331
 
<tr>
332
 
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
333
 
<td>a callback to call when the request is satisfied
334
 
</td>
335
 
</tr>
336
 
<tr>
337
 
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
338
 
<td>data to pass to <em class="parameter"><code>callback</code></em>
339
 
</td>
340
 
</tr>
341
 
</tbody>
342
 
</table></div>
343
 
</div>
344
 
<hr>
345
 
<div class="refsect2" title="tpl_log_manager_get_dates_finish ()">
346
 
<a name="tpl-log-manager-get-dates-finish"></a><h3>tpl_log_manager_get_dates_finish ()</h3>
347
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            tpl_log_manager_get_dates_finish    (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *self</code></em>,
348
 
                                                         <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
349
 
                                                         <em class="parameter"><code><span class="type">GList</span> **dates</code></em>,
350
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
351
 
<div class="variablelist"><table border="0">
352
 
<col align="left" valign="top">
353
 
<tbody>
354
 
<tr>
355
 
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
356
 
<td>a <a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a>
357
 
</td>
358
 
</tr>
359
 
<tr>
360
 
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
361
 
<td>a <span class="type">GAsyncResult</span>
362
 
</td>
363
 
</tr>
364
 
<tr>
365
 
<td><p><span class="term"><em class="parameter"><code>dates</code></em> :</span></p></td>
366
 
<td>a pointer to a <span class="type">GList</span> used to return the list of <span class="type">GDate</span>
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 <span class="type">GError</span> to fill
372
 
</td>
373
 
</tr>
374
 
<tr>
375
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
376
 
<td> <span class="type">TRUE</span> if the operation was successful, otherwise <span class="type">FALSE</span>
377
 
</td>
378
 
</tr>
379
 
</tbody>
380
 
</table></div>
381
 
</div>
382
 
<hr>
383
 
<div class="refsect2" title="tpl_log_manager_get_events_for_date_async ()">
384
 
<a name="tpl-log-manager-get-events-for-date-async"></a><h3>tpl_log_manager_get_events_for_date_async ()</h3>
385
 
<pre class="programlisting"><span class="returnvalue">void</span>                tpl_log_manager_get_events_for_date_async
386
 
                                                        (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *manager</code></em>,
387
 
                                                         <em class="parameter"><code><a href="http://telepathy.freedesktop.org/doc/telepathy-glib/telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
388
 
                                                         <em class="parameter"><code><a class="link" href="TplEntity.html" title="TplEntity"><span class="type">TplEntity</span></a> *target</code></em>,
389
 
                                                         <em class="parameter"><code><span class="type">gint</span> type_mask</code></em>,
390
 
                                                         <em class="parameter"><code>const <span class="type">GDate</span> *date</code></em>,
391
 
                                                         <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
392
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
393
 
<p>
394
 
Retrieve a list of <a class="link" href="TplEvent.html" title="TplEvent"><span class="type">TplEvent</span></a> at <em class="parameter"><code>date</code></em> with <em class="parameter"><code>target</code></em>.
395
 
</p>
396
 
<div class="variablelist"><table border="0">
397
 
<col align="left" valign="top">
398
 
<tbody>
399
 
<tr>
400
 
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
401
 
<td>a <a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a>
402
 
</td>
403
 
</tr>
404
 
<tr>
405
 
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
406
 
<td>a <a href="http://telepathy.freedesktop.org/doc/telepathy-glib/telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
407
 
</td>
408
 
</tr>
409
 
<tr>
410
 
<td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
411
 
<td>a non-NULL <a class="link" href="TplEntity.html" title="TplEntity"><span class="type">TplEntity</span></a>
412
 
</td>
413
 
</tr>
414
 
<tr>
415
 
<td><p><span class="term"><em class="parameter"><code>type_mask</code></em> :</span></p></td>
416
 
<td>event type filter see <a class="link" href="TplLogManager.html#TplEventTypeMask" title="enum TplEventTypeMask"><span class="type">TplEventTypeMask</span></a>
417
 
</td>
418
 
</tr>
419
 
<tr>
420
 
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
421
 
<td>a <span class="type">GDate</span>
422
 
</td>
423
 
</tr>
424
 
<tr>
425
 
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
426
 
<td>a callback to call when the request is satisfied
427
 
</td>
428
 
</tr>
429
 
<tr>
430
 
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
431
 
<td>data to pass to <em class="parameter"><code>callback</code></em>
432
 
</td>
433
 
</tr>
434
 
</tbody>
435
 
</table></div>
436
 
</div>
437
 
<hr>
438
 
<div class="refsect2" title="tpl_log_manager_get_events_for_date_finish ()">
439
 
<a name="tpl-log-manager-get-events-for-date-finish"></a><h3>tpl_log_manager_get_events_for_date_finish ()</h3>
440
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            tpl_log_manager_get_events_for_date_finish
441
 
                                                        (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *self</code></em>,
442
 
                                                         <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
443
 
                                                         <em class="parameter"><code><span class="type">GList</span> **events</code></em>,
444
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
445
 
<div class="variablelist"><table border="0">
446
 
<col align="left" valign="top">
447
 
<tbody>
448
 
<tr>
449
 
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
450
 
<td>a <a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a>
451
 
</td>
452
 
</tr>
453
 
<tr>
454
 
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
455
 
<td>a <span class="type">GAsyncResult</span>
456
 
</td>
457
 
</tr>
458
 
<tr>
459
 
<td><p><span class="term"><em class="parameter"><code>events</code></em> :</span></p></td>
460
 
<td>a pointer to a <span class="type">GList</span> used to return the list of <a class="link" href="TplEvent.html" title="TplEvent"><span class="type">TplEvent</span></a>
461
 
</td>
462
 
</tr>
463
 
<tr>
464
 
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
465
 
<td>a <span class="type">GError</span> to fill
466
 
</td>
467
 
</tr>
468
 
<tr>
469
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
470
 
<td> <span class="type">TRUE</span> if the operation was successful, otherwise <span class="type">FALSE</span>
471
 
</td>
472
 
</tr>
473
 
</tbody>
474
 
</table></div>
475
 
</div>
476
 
<hr>
477
 
<div class="refsect2" title="tpl_log_manager_get_filtered_events_async ()">
478
 
<a name="tpl-log-manager-get-filtered-events-async"></a><h3>tpl_log_manager_get_filtered_events_async ()</h3>
479
 
<pre class="programlisting"><span class="returnvalue">void</span>                tpl_log_manager_get_filtered_events_async
480
 
                                                        (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *manager</code></em>,
481
 
                                                         <em class="parameter"><code><a href="http://telepathy.freedesktop.org/doc/telepathy-glib/telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
482
 
                                                         <em class="parameter"><code><a class="link" href="TplEntity.html" title="TplEntity"><span class="type">TplEntity</span></a> *target</code></em>,
483
 
                                                         <em class="parameter"><code><span class="type">gint</span> type_mask</code></em>,
484
 
                                                         <em class="parameter"><code><span class="type">guint</span> num_events</code></em>,
485
 
                                                         <em class="parameter"><code><a class="link" href="TplLogManager.html#TplLogEventFilter" title="TplLogEventFilter ()"><span class="type">TplLogEventFilter</span></a> filter</code></em>,
486
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> filter_user_data</code></em>,
487
 
                                                         <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
488
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
489
 
<p>
490
 
Retrieve the most recent <em class="parameter"><code>num_event</code></em> events exchanged with <em class="parameter"><code>target</code></em>.
491
 
</p>
492
 
<div class="variablelist"><table border="0">
493
 
<col align="left" valign="top">
494
 
<tbody>
495
 
<tr>
496
 
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
497
 
<td>a <a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a>
498
 
</td>
499
 
</tr>
500
 
<tr>
501
 
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
502
 
<td>a <a href="http://telepathy.freedesktop.org/doc/telepathy-glib/telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
503
 
</td>
504
 
</tr>
505
 
<tr>
506
 
<td><p><span class="term"><em class="parameter"><code>target</code></em> :</span></p></td>
507
 
<td>a non-NULL <a class="link" href="TplEntity.html" title="TplEntity"><span class="type">TplEntity</span></a>
508
 
</td>
509
 
</tr>
510
 
<tr>
511
 
<td><p><span class="term"><em class="parameter"><code>type_mask</code></em> :</span></p></td>
512
 
<td>event type filter see <a class="link" href="TplLogManager.html#TplEventTypeMask" title="enum TplEventTypeMask"><span class="type">TplEventTypeMask</span></a>
513
 
</td>
514
 
</tr>
515
 
<tr>
516
 
<td><p><span class="term"><em class="parameter"><code>num_events</code></em> :</span></p></td>
517
 
<td>number of maximum events to fetch
518
 
</td>
519
 
</tr>
520
 
<tr>
521
 
<td><p><span class="term"><em class="parameter"><code>filter</code></em> :</span></p></td>
522
 
<td> an optional filter function. <span class="annotation">[<a href="http://foldoc.org/scope%20async"><span class="acronym">scope async</span></a>]</span>
523
 
</td>
524
 
</tr>
525
 
<tr>
526
 
<td><p><span class="term"><em class="parameter"><code>filter_user_data</code></em> :</span></p></td>
527
 
<td>user data to pass to <em class="parameter"><code>filter</code></em>
528
 
</td>
529
 
</tr>
530
 
<tr>
531
 
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
532
 
<td> a callback to call when the request is satisfied. <span class="annotation">[<a href="http://foldoc.org/scope%20async"><span class="acronym">scope async</span></a>]</span>
533
 
</td>
534
 
</tr>
535
 
<tr>
536
 
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
537
 
<td>data to pass to <em class="parameter"><code>callback</code></em>
538
 
</td>
539
 
</tr>
540
 
</tbody>
541
 
</table></div>
542
 
</div>
543
 
<hr>
544
 
<div class="refsect2" title="tpl_log_manager_get_filtered_events_finish ()">
545
 
<a name="tpl-log-manager-get-filtered-events-finish"></a><h3>tpl_log_manager_get_filtered_events_finish ()</h3>
546
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            tpl_log_manager_get_filtered_events_finish
547
 
                                                        (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *self</code></em>,
548
 
                                                         <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
549
 
                                                         <em class="parameter"><code><span class="type">GList</span> **events</code></em>,
550
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
551
 
<div class="variablelist"><table border="0">
552
 
<col align="left" valign="top">
553
 
<tbody>
554
 
<tr>
555
 
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
556
 
<td>a <a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a>
557
 
</td>
558
 
</tr>
559
 
<tr>
560
 
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
561
 
<td>a <span class="type">GAsyncResult</span>
562
 
</td>
563
 
</tr>
564
 
<tr>
565
 
<td><p><span class="term"><em class="parameter"><code>events</code></em> :</span></p></td>
566
 
<td>
567
 
 a pointer to a <span class="type">GList</span> used to return the list <a class="link" href="TplEvent.html" title="TplEvent"><span class="type">TplEvent</span></a>. <span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>][<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>][<a href="http://foldoc.org/element-type"><span class="acronym">element-type</span></a> TelepathyLogger.Event]</span>
568
 
</td>
569
 
</tr>
570
 
<tr>
571
 
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
572
 
<td> a <span class="type">GError</span> to fill. <span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a> caller-allocates]</span>
573
 
</td>
574
 
</tr>
575
 
<tr>
576
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
577
 
<td> <span class="type">TRUE</span> if the operation was successful, otherwise <span class="type">FALSE</span>.
578
 
</td>
579
 
</tr>
580
 
</tbody>
581
 
</table></div>
582
 
</div>
583
 
<hr>
584
 
<div class="refsect2" title="tpl_log_manager_get_entities_async ()">
585
 
<a name="tpl-log-manager-get-entities-async"></a><h3>tpl_log_manager_get_entities_async ()</h3>
586
 
<pre class="programlisting"><span class="returnvalue">void</span>                tpl_log_manager_get_entities_async  (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *self</code></em>,
587
 
                                                         <em class="parameter"><code><a href="http://telepathy.freedesktop.org/doc/telepathy-glib/telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a> *account</code></em>,
588
 
                                                         <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
589
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
590
 
<p>
591
 
Start a query looking for all entities for which you have logs in the <em class="parameter"><code>account</code></em>.
592
 
</p>
593
 
<div class="variablelist"><table border="0">
594
 
<col align="left" valign="top">
595
 
<tbody>
596
 
<tr>
597
 
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
598
 
<td>a <a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a>
599
 
</td>
600
 
</tr>
601
 
<tr>
602
 
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
603
 
<td>a <a href="http://telepathy.freedesktop.org/doc/telepathy-glib/telepathy-glib-account.html#TpAccount"><span class="type">TpAccount</span></a>
604
 
</td>
605
 
</tr>
606
 
<tr>
607
 
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
608
 
<td>a callback to call when the request is satisfied
609
 
</td>
610
 
</tr>
611
 
<tr>
612
 
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
613
 
<td>data to pass to <em class="parameter"><code>callback</code></em>
614
 
</td>
615
 
</tr>
616
 
</tbody>
617
 
</table></div>
618
 
</div>
619
 
<hr>
620
 
<div class="refsect2" title="tpl_log_manager_get_entities_finish ()">
621
 
<a name="tpl-log-manager-get-entities-finish"></a><h3>tpl_log_manager_get_entities_finish ()</h3>
622
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            tpl_log_manager_get_entities_finish (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *self</code></em>,
623
 
                                                         <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
624
 
                                                         <em class="parameter"><code><span class="type">GList</span> **entities</code></em>,
625
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
626
 
<div class="variablelist"><table border="0">
627
 
<col align="left" valign="top">
628
 
<tbody>
629
 
<tr>
630
 
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
631
 
<td>a <a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a>
632
 
</td>
633
 
</tr>
634
 
<tr>
635
 
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
636
 
<td>a <span class="type">GAsyncResult</span>
637
 
</td>
638
 
</tr>
639
 
<tr>
640
 
<td><p><span class="term"><em class="parameter"><code>entities</code></em> :</span></p></td>
641
 
<td>a pointer to a <span class="type">GList</span> used to return the list of <a class="link" href="TplEntity.html" title="TplEntity"><span class="type">TplEntity</span></a>, to be
642
 
        freed using something like g_list_free_full (lst, g_object_unref)
643
 
</td>
644
 
</tr>
645
 
<tr>
646
 
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
647
 
<td>a <span class="type">GError</span> to fill
648
 
</td>
649
 
</tr>
650
 
<tr>
651
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
652
 
<td> <span class="type">TRUE</span> if the operation was successful, otherwise <span class="type">FALSE</span>
653
 
</td>
654
 
</tr>
655
 
</tbody>
656
 
</table></div>
657
 
</div>
658
 
<hr>
659
 
<div class="refsect2" title="tpl_log_manager_search_async ()">
660
 
<a name="tpl-log-manager-search-async"></a><h3>tpl_log_manager_search_async ()</h3>
661
 
<pre class="programlisting"><span class="returnvalue">void</span>                tpl_log_manager_search_async        (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *manager</code></em>,
662
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
663
 
                                                         <em class="parameter"><code><span class="type">gint</span> type_mask</code></em>,
664
 
                                                         <em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
665
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
666
 
<p>
667
 
Search for all the conversations containing <em class="parameter"><code>text</code></em>.
668
 
</p>
669
 
<div class="variablelist"><table border="0">
670
 
<col align="left" valign="top">
671
 
<tbody>
672
 
<tr>
673
 
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
674
 
<td>a <a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a>
675
 
</td>
676
 
</tr>
677
 
<tr>
678
 
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
679
 
<td>the pattern to search
680
 
</td>
681
 
</tr>
682
 
<tr>
683
 
<td><p><span class="term"><em class="parameter"><code>type_mask</code></em> :</span></p></td>
684
 
<td>event type filter see <a class="link" href="TplLogManager.html#TplEventTypeMask" title="enum TplEventTypeMask"><span class="type">TplEventTypeMask</span></a>
685
 
</td>
686
 
</tr>
687
 
<tr>
688
 
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
689
 
<td>a callback to call when the request is satisfied
690
 
</td>
691
 
</tr>
692
 
<tr>
693
 
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
694
 
<td>data to pass to <em class="parameter"><code>callback</code></em>
695
 
</td>
696
 
</tr>
697
 
</tbody>
698
 
</table></div>
699
 
</div>
700
 
<hr>
701
 
<div class="refsect2" title="tpl_log_manager_search_finish ()">
702
 
<a name="tpl-log-manager-search-finish"></a><h3>tpl_log_manager_search_finish ()</h3>
703
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            tpl_log_manager_search_finish       (<em class="parameter"><code><a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a> *self</code></em>,
704
 
                                                         <em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
705
 
                                                         <em class="parameter"><code><span class="type">GList</span> **hits</code></em>,
706
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
707
 
<div class="variablelist"><table border="0">
708
 
<col align="left" valign="top">
709
 
<tbody>
710
 
<tr>
711
 
<td><p><span class="term"><em class="parameter"><code>self</code></em> :</span></p></td>
712
 
<td>a <a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a>
713
 
</td>
714
 
</tr>
715
 
<tr>
716
 
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
717
 
<td>a <span class="type">GAsyncResult</span>
718
 
</td>
719
 
</tr>
720
 
<tr>
721
 
<td><p><span class="term"><em class="parameter"><code>hits</code></em> :</span></p></td>
722
 
<td>a pointer to a <span class="type">GList</span> used to return the list of <span class="type">TplLogSearchHit</span>
723
 
</td>
724
 
</tr>
725
 
<tr>
726
 
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
727
 
<td>a <span class="type">GError</span> to fill
728
 
</td>
729
 
</tr>
730
 
<tr>
731
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
732
 
<td> <span class="type">TRUE</span> if the operation was successful, otherwise <span class="type">FALSE</span>
733
 
</td>
734
 
</tr>
735
 
</tbody>
736
 
</table></div>
737
 
</div>
738
 
<hr>
739
 
<div class="refsect2" title="tpl_log_manager_search_free ()">
740
 
<a name="tpl-log-manager-search-free"></a><h3>tpl_log_manager_search_free ()</h3>
741
 
<pre class="programlisting"><span class="returnvalue">void</span>                tpl_log_manager_search_free         (<em class="parameter"><code><span class="type">GList</span> *hits</code></em>);</pre>
742
 
<p>
743
 
Free <em class="parameter"><code>hits</code></em> and its content.
744
 
</p>
745
 
<div class="variablelist"><table border="0">
746
 
<col align="left" valign="top">
747
 
<tbody><tr>
748
 
<td><p><span class="term"><em class="parameter"><code>hits</code></em> :</span></p></td>
749
 
<td>a <span class="type">GList</span> of <span class="type">TplLogSearchHit</span>
750
 
</td>
751
 
</tr></tbody>
752
 
</table></div>
753
 
</div>
754
 
</div>
755
 
</div>
756
 
<div class="footer">
757
 
<hr>
758
 
          Generated by GTK-Doc V1.15</div>
759
 
</body>
760
 
</html>
 
 
b'\\ No newline at end of file'