![]() |
![]() |
![]() |
telepathy-logger Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy |
#define TPL_LOG_MANAGER_ERROR GQuark tpl_log_manager_errors_quark (void
); enum TplLogManagerError; TplLogManager; enum TplEventTypeMask; gboolean (*TplLogEventFilter) (TplEvent *event
,gpointer user_data
); TplLogManager * tpl_log_manager_dup_singleton (void
); gboolean tpl_log_manager_exists (TplLogManager *manager
,TpAccount *account
,TplEntity *target
,gint type_mask
); void tpl_log_manager_get_dates_async (TplLogManager *manager
,TpAccount *account
,TplEntity *target
,gint type_mask
,GAsyncReadyCallback callback
,gpointer user_data
); gboolean tpl_log_manager_get_dates_finish (TplLogManager *self
,GAsyncResult *result
,GList **dates
,GError **error
); void tpl_log_manager_get_events_for_date_async (TplLogManager *manager
,TpAccount *account
,TplEntity *target
,gint type_mask
,const GDate *date
,GAsyncReadyCallback callback
,gpointer user_data
); gboolean tpl_log_manager_get_events_for_date_finish (TplLogManager *self
,GAsyncResult *result
,GList **events
,GError **error
); void tpl_log_manager_get_filtered_events_async (TplLogManager *manager
,TpAccount *account
,TplEntity *target
,gint type_mask
,guint num_events
,TplLogEventFilter filter
,gpointer filter_user_data
,GAsyncReadyCallback callback
,gpointer user_data
); gboolean tpl_log_manager_get_filtered_events_finish (TplLogManager *self
,GAsyncResult *result
,GList **events
,GError **error
); void tpl_log_manager_get_entities_async (TplLogManager *self
,TpAccount *account
,GAsyncReadyCallback callback
,gpointer user_data
); gboolean tpl_log_manager_get_entities_finish (TplLogManager *self
,GAsyncResult *result
,GList **entities
,GError **error
); void tpl_log_manager_search_async (TplLogManager *manager
,const gchar *text
,gint type_mask
,GAsyncReadyCallback callback
,gpointer user_data
); gboolean tpl_log_manager_search_finish (TplLogManager *self
,GAsyncResult *result
,GList **hits
,GError **error
); void tpl_log_manager_search_free (GList *hits
);
#define TPL_LOG_MANAGER_ERROR tpl_log_manager_errors_quark()
The error domain for the TplLogManager.
GQuark tpl_log_manager_errors_quark (void
);
Returns : |
the GQuark associated with the error domain of TplLogManager |
typedef enum { TPL_EVENT_MASK_TEXT = 1 << 0, TPL_EVENT_MASK_CALL = 1 << 1, TPL_EVENT_MASK_ANY = 0xffff } TplEventTypeMask;
Mask used to filter type of TplEvent returned.
Mask to TplTextEvent | |
Special value to select all type of TplEvent |
gboolean (*TplLogEventFilter) (TplEvent *event
,gpointer user_data
);
|
the TplEvent to filter |
|
user-supplied data |
Returns : |
TRUE if event should appear in the result
|
TplLogManager * tpl_log_manager_dup_singleton (void
);
Returns : |
a new reference on the log manager. [transfer full] |
gboolean tpl_log_manager_exists (TplLogManager *manager
,TpAccount *account
,TplEntity *target
,gint type_mask
);
Checks if logs exist for target
.
It applies for any registered TplLogStore with the "readable"
property TRUE
.
|
TplLogManager |
|
TpAccount |
|
a non-NULL TplEntity |
|
event type filter see TplEventTypeMask |
Returns : |
TRUE logs exist for target , otherwise FALSE
|
void tpl_log_manager_get_dates_async (TplLogManager *manager
,TpAccount *account
,TplEntity *target
,gint type_mask
,GAsyncReadyCallback callback
,gpointer user_data
);
Retrieves a list of GDate corresponding to each day where
at least one event exist for target
.
It applies for any registered TplLogStore with the "readable"
property TRUE
.
|
a TplLogManager |
|
a TpAccount |
|
a non-NULL TplEntity |
|
event type filter see TplEventTypeMask |
|
a callback to call when the request is satisfied |
|
data to pass to callback
|
gboolean tpl_log_manager_get_dates_finish (TplLogManager *self
,GAsyncResult *result
,GList **dates
,GError **error
);
|
a TplLogManager |
|
a GAsyncResult |
|
a pointer to a GList used to return the list of GDate |
|
a GError to fill |
Returns : |
TRUE if the operation was successful, otherwise FALSE |
void tpl_log_manager_get_events_for_date_async (TplLogManager *manager
,TpAccount *account
,TplEntity *target
,gint type_mask
,const GDate *date
,GAsyncReadyCallback callback
,gpointer user_data
);
Retrieve a list of TplEvent at date
with target
.
|
a TplLogManager |
|
a TpAccount |
|
a non-NULL TplEntity |
|
event type filter see TplEventTypeMask |
|
a GDate |
|
a callback to call when the request is satisfied |
|
data to pass to callback
|
gboolean tpl_log_manager_get_events_for_date_finish (TplLogManager *self
,GAsyncResult *result
,GList **events
,GError **error
);
|
a TplLogManager |
|
a GAsyncResult |
|
a pointer to a GList used to return the list of TplEvent |
|
a GError to fill |
Returns : |
TRUE if the operation was successful, otherwise FALSE |
void tpl_log_manager_get_filtered_events_async (TplLogManager *manager
,TpAccount *account
,TplEntity *target
,gint type_mask
,guint num_events
,TplLogEventFilter filter
,gpointer filter_user_data
,GAsyncReadyCallback callback
,gpointer user_data
);
Retrieve the most recent num_event
events exchanged with target
.
|
a TplLogManager |
|
a TpAccount |
|
a non-NULL TplEntity |
|
event type filter see TplEventTypeMask |
|
number of maximum events to fetch |
|
an optional filter function. [scope async] |
|
user data to pass to filter
|
|
a callback to call when the request is satisfied. [scope async] |
|
data to pass to callback
|
gboolean tpl_log_manager_get_filtered_events_finish (TplLogManager *self
,GAsyncResult *result
,GList **events
,GError **error
);
|
a TplLogManager |
|
a GAsyncResult |
|
a pointer to a GList used to return the list TplEvent. [out][transfer full][element-type TelepathyLogger.Event] |
|
a GError to fill. [out caller-allocates] |
Returns : |
TRUE if the operation was successful, otherwise FALSE. |
void tpl_log_manager_get_entities_async (TplLogManager *self
,TpAccount *account
,GAsyncReadyCallback callback
,gpointer user_data
);
Start a query looking for all entities for which you have logs in the account
.
|
a TplLogManager |
|
a TpAccount |
|
a callback to call when the request is satisfied |
|
data to pass to callback
|
gboolean tpl_log_manager_get_entities_finish (TplLogManager *self
,GAsyncResult *result
,GList **entities
,GError **error
);
|
a TplLogManager |
|
a GAsyncResult |
|
a pointer to a GList used to return the list of TplEntity, to be freed using something like g_list_free_full (lst, g_object_unref) |
|
a GError to fill |
Returns : |
TRUE if the operation was successful, otherwise FALSE |
void tpl_log_manager_search_async (TplLogManager *manager
,const gchar *text
,gint type_mask
,GAsyncReadyCallback callback
,gpointer user_data
);
Search for all the conversations containing text
.
|
a TplLogManager |
|
the pattern to search |
|
event type filter see TplEventTypeMask |
|
a callback to call when the request is satisfied |
|
data to pass to callback
|
gboolean tpl_log_manager_search_finish (TplLogManager *self
,GAsyncResult *result
,GList **hits
,GError **error
);
|
a TplLogManager |
|
a GAsyncResult |
|
a pointer to a GList used to return the list of TplLogSearchHit |
|
a GError to fill |
Returns : |
TRUE if the operation was successful, otherwise FALSE |