1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
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">
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">
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>
23
<tr><td colspan="5" class="shortcuts">
24
<a href="#TplLogManager.synopsis" class="shortcut">Top</a>
26
<a href="#TplLogManager.description" class="shortcut">Description</a>
28
<a href="#TplLogManager.object-hierarchy" class="shortcut">Object Hierarchy</a>
31
<div class="refentry" title="TplLogManager">
32
<a name="TplLogManager"></a><div class="titlepage"></div>
33
<div class="refnamediv"><table width="100%"><tr>
35
<h2><span class="refentrytitle"><a name="TplLogManager.top_of_page"></a>TplLogManager</span></h2>
36
<p>TplLogManager — Fetch and search through logs</p>
38
<td valign="top" align="right"></td>
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>);
112
<div class="refsect1" title="Object Hierarchy">
113
<a name="TplLogManager.object-hierarchy"></a><h2>Object Hierarchy</h2>
114
<pre class="synopsis">
119
<div class="refsect1" title="Description">
120
<a name="TplLogManager.description"></a><h2>Description</h2>
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.
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()
132
The error domain for the <a class="link" href="TplLogManager.html" title="TplLogManager"><span class="type">TplLogManager</span></a>.
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">
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>
149
<div class="refsect2" title="enum TplLogManagerError">
150
<a name="TplLogManagerError"></a><h3>enum TplLogManagerError</h3>
151
<pre class="programlisting">typedef enum
153
TPL_LOG_MANAGER_ERROR_ADD_EVENT
154
} TplLogManagerError;
156
<div class="variablelist"><table border="0">
157
<col align="left" valign="top">
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
166
<div class="refsect2" title="TplLogManager">
167
<a name="TplLogManager-struct"></a><h3>TplLogManager</h3>
168
<pre class="programlisting">typedef struct _TplLogManager TplLogManager;</pre>
170
An object used to access logs
174
<div class="refsect2" title="enum TplEventTypeMask">
175
<a name="TplEventTypeMask"></a><h3>enum TplEventTypeMask</h3>
176
<pre class="programlisting">typedef enum
178
TPL_EVENT_MASK_TEXT = 1 << 0,
179
TPL_EVENT_MASK_CALL = 1 << 1,
180
TPL_EVENT_MASK_ANY = 0xffff
184
Mask used to filter type of <a class="link" href="TplEvent.html" title="TplEvent"><span class="type">TplEvent</span></a> returned.
186
<div class="variablelist"><table border="0">
187
<col align="left" valign="top">
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>
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>
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>
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">
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
221
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
222
<td>user-supplied data
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
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">
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>
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>
254
Checks if logs exist for <em class="parameter"><code>target</code></em>.
257
It applies for any registered TplLogStore with the <span class="type">"readable"</span>
258
property <code class="literal">TRUE</code>.
260
<div class="variablelist"><table border="0">
261
<col align="left" valign="top">
264
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
269
<td><p><span class="term"><em class="parameter"><code>account</code></em> :</span></p></td>
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>
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>
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>
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>
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>.
305
It applies for any registered TplLogStore with the <span class="type">"readable"</span>
306
property <code class="literal">TRUE</code>.
308
<div class="variablelist"><table border="0">
309
<col align="left" valign="top">
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>
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>
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>
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>
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
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>
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">
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>
360
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
361
<td>a <span class="type">GAsyncResult</span>
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>
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
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>
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>
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>.
396
<div class="variablelist"><table border="0">
397
<col align="left" valign="top">
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>
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>
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>
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>
420
<td><p><span class="term"><em class="parameter"><code>date</code></em> :</span></p></td>
421
<td>a <span class="type">GDate</span>
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
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>
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">
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>
454
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
455
<td>a <span class="type">GAsyncResult</span>
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>
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
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>
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>
490
Retrieve the most recent <em class="parameter"><code>num_event</code></em> events exchanged with <em class="parameter"><code>target</code></em>.
492
<div class="variablelist"><table border="0">
493
<col align="left" valign="top">
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>
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>
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>
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>
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
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>
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>
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>
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>
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">
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>
560
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
561
<td>a <span class="type">GAsyncResult</span>
565
<td><p><span class="term"><em class="parameter"><code>events</code></em> :</span></p></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>
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>
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>.
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>
591
Start a query looking for all entities for which you have logs in the <em class="parameter"><code>account</code></em>.
593
<div class="variablelist"><table border="0">
594
<col align="left" valign="top">
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>
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>
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
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>
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">
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>
635
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
636
<td>a <span class="type">GAsyncResult</span>
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)
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
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>
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>
667
Search for all the conversations containing <em class="parameter"><code>text</code></em>.
669
<div class="variablelist"><table border="0">
670
<col align="left" valign="top">
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>
678
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
679
<td>the pattern to search
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>
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
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>
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">
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>
716
<td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
717
<td>a <span class="type">GAsyncResult</span>
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>
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
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>
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>
743
Free <em class="parameter"><code>hits</code></em> and its content.
745
<div class="variablelist"><table border="0">
746
<col align="left" valign="top">
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>
758
Generated by GTK-Doc V1.15</div>
b'\\ No newline at end of file'