~darkxst/ubuntu/quantal/telepathy-logger/lp1049210

« back to all changes in this revision

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

  • Committer: Bazaar Package Importer
  • Author(s): Laurent Bigonville
  • Date: 2011-04-01 10:10:05 UTC
  • mto: (14.1.1 experimental) (19.1.1 sid)
  • mto: This revision was merged to the branch mainline in revision 16.
  • Revision ID: james.westby@ubuntu.com-20110401101005-cu311xa4s0esdhpv
Tags: upstream-0.2.8
Import upstream version 0.2.8

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.75.2">
 
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'