Tracker Client Library Reference Manual | ||||
---|---|---|---|---|
Top | Description |
Synopsis
#include <libtracker-client/tracker-client.h> void (*TrackerReplyArray) (gchar **result
,GError *error
,gpointer user_data
); TrackerClient * tracker_connect (gboolean enable_warnings
,gint timeout
); void tracker_disconnect (TrackerClient *client
); guint tracker_search_metadata_by_text_async (TrackerClient *client
,const gchar *query
,TrackerReplyArray callback
,gpointer user_data
); guint tracker_search_metadata_by_text_and_location_async (TrackerClient *client
,const gchar *query
,const gchar *location
,TrackerReplyArray callback
,gpointer user_data
); guint tracker_search_metadata_by_text_and_mime_async (TrackerClient *client
,const gchar *query
,const gchar **mimes
,TrackerReplyArray callback
,gpointer user_data
); guint tracker_search_metadata_by_text_and_mime_and_location_async (TrackerClient *client
,const gchar *query
,const gchar **mimes
,const gchar *location
,TrackerReplyArray callback
,gpointer user_data
);
Details
TrackerReplyArray ()
void (*TrackerReplyArray) (gchar **result
,GError *error
,gpointer user_data
);
Warning
TrackerReplyArray
has been deprecated since version 0.8 and should not be used in newly-written code. Use TrackerReplyVoid and TrackerReplyGPtrArray
with tracker_resources_sparql_query()
instead.
This is used by the 0.6 Tracker APIs:
tracker_search_metadata_by_text_async()
tracker_search_metadata_by_text_and_location_async()
tracker_search_metadata_by_text_and_mime_async()
tracker_search_metadata_by_text_and_mime_and_location_async()
|
a gchar ** with the results of the query. |
|
a GError. |
|
a gpointer for user data. |
tracker_connect ()
TrackerClient * tracker_connect (gboolean enable_warnings
,gint timeout
);
Warning
tracker_connect
has been deprecated since version 0.8 and should not be used in newly-written code. Use tracker_client_new()
instead.
This function calls tracker_client_new()
.
|
a gboolean to determine if warnings are issued in cases where they are found. |
|
a gint used for D-Bus call timeouts. |
Returns : |
a TrackerClient GObject which must be freed with
g_object_unref() . |
tracker_disconnect ()
void tracker_disconnect (TrackerClient *client
);
Warning
tracker_disconnect
has been deprecated since version 0.8 and should not be used in newly-written code. Use g_object_unref()
instead.
This will disconnect the D-Bus connections to Tracker services and
free the allocated TrackerClient by tracker_connect()
.
|
a TrackerClient. |
tracker_search_metadata_by_text_async ()
guint tracker_search_metadata_by_text_async (TrackerClient *client
,const gchar *query
,TrackerReplyArray callback
,gpointer user_data
);
Warning
tracker_search_metadata_by_text_async
has been deprecated since version 0.8 and should not be used in newly-written code. Use tracker_resources_sparql_query()
instead.
Searches for query
in all URIs with the prefix location
.
NOTE: query
is found using FTS (Full Text Search).
|
a TrackerClient. |
|
a string representing what to search for. |
|
callback function to be called when the update has been processed. |
|
user data to pass to callback . |
Returns : |
A guint representing the operation ID. See
tracker_cancel_call() . In the event of failure, 0 is returned. |
tracker_search_metadata_by_text_and_location_async ()
guint tracker_search_metadata_by_text_and_location_async (TrackerClient *client
,const gchar *query
,const gchar *location
,TrackerReplyArray callback
,gpointer user_data
);
Warning
tracker_search_metadata_by_text_and_location_async
has been deprecated since version 0.8 and should not be used in newly-written code. Use tracker_resources_sparql_query()
instead.
Searches for query
in all URIs with the prefix location
.
NOTE: query
is found using FTS (Full Text Search).
|
a TrackerClient. |
|
a string representing what to search for. |
|
a string representing a path. |
|
callback function to be called when the update has been processed. |
|
user data to pass to callback . |
Returns : |
A guint representing the operation ID. See
tracker_cancel_call() . In the event of failure, 0 is returned. |
tracker_search_metadata_by_text_and_mime_async ()
guint tracker_search_metadata_by_text_and_mime_async (TrackerClient *client
,const gchar *query
,const gchar **mimes
,TrackerReplyArray callback
,gpointer user_data
);
Warning
tracker_search_metadata_by_text_and_mime_async
has been deprecated since version 0.8 and should not be used in newly-written code. Use tracker_resources_sparql_query()
instead.
Searches for query
in all URIs with a mime type matching any of
the values in mime
.
NOTE: query
is found using FTS (Full Text Search).
|
a TrackerClient. |
|
a string representing what to search for. |
|
a GStrv representing mime types. |
|
callback function to be called when the update has been processed. |
|
user data to pass to callback . |
Returns : |
A guint representing the operation ID. See
tracker_cancel_call() . In the event of failure, 0 is returned. |
tracker_search_metadata_by_text_and_mime_and_location_async ()
guint tracker_search_metadata_by_text_and_mime_and_location_async (TrackerClient *client
,const gchar *query
,const gchar **mimes
,const gchar *location
,TrackerReplyArray callback
,gpointer user_data
);
Warning
tracker_search_metadata_by_text_and_mime_and_location_async
has been deprecated since version 0.8 and should not be used in newly-written code. Use tracker_resources_sparql_query()
instead.
Searches for query
in all URIs with the prefix location
and with
a mime type matching any of the values in mime
.
NOTE: query
is found using FTS (Full Text Search).
|
a TrackerClient. |
|
a string representing what to search for. |
|
a GStrv representing mime types. |
|
a string representing a path. |
|
callback function to be called when the update has been processed. |
|
user data to pass to callback . |
Returns : |
A guint representing the operation ID. See
tracker_cancel_call() . In the event of failure, 0 is returned. |