XesamGQuery

typedef struct _XesamGQuery XesamGQuery;

xesam_g_query_get_xml ()

const gchar*        xesam_g_query_get_xml               (XesamGQuery *query);

Get an XML representation of a query. The XML will be cached until the query is changed.

xesam_g_query_new_from_text ()

XesamGQuery*        xesam_g_query_new_from_text         (const gchar *search_text);

Create a new query based on a user supplied string conforming to the XESAM User Search Language Spec.

In contrast to xesam_g_query_new_from_textf this method is safe to use on user supplied input.

xesam_g_query_new_from_textf ()

XesamGQuery*        xesam_g_query_new_from_textf        (const gchar *format,
                                                         ...);

Create a new query based on a printf-style argument. The formatted result must conform to the XESAM User Search Language Spec.

WARNING: Be cautious if you use this method on user supplied input. Any formatting characters should be escaped.

xesam_g_query_new_from_xml ()

XesamGQuery*        xesam_g_query_new_from_xml          (const gchar *query_xml);

Create a new query containing the raw xml supplied in the constructor. The xml should conform to the XESAM Query Language specification, although this will not be checked on construction time.