rtcom-eventlogger/eventlogger-query.h

Go to the documentation of this file.

#ifndef __QUERY_H
#define __QUERY_H

#include "rtcom-eventlogger/eventlogger-types.h"

#include <glib-object.h>

G_BEGIN_DECLS

#define RTCOM_TYPE_EL_QUERY             (rtcom_el_query_get_type ())
#define RTCOM_EL_QUERY(obj)             (G_TYPE_CHECK_INSTANCE_CAST ((obj), RTCOM_TYPE_EL_QUERY, RTComElQuery))
#define RTCOM_EL_QUERY_CLASS(klass)     (G_TYPE_CHECK_CLASS_CAST ((klass), RTCOM_TYPE_EL_QUERY, RTComElQueryClass))
#define RTCOM_IS_EL_QUERY(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), RTCOM_TYPE_EL_QUERY))
#define RTCOM_IS_EL_QUERY_CLASS(klass)  (G_TYPE_CHECK_CLASS_TYPE ((klass), RTCOM_TYPE_EL_QUERY))
#define RTCOM_EL_QUERY_GET_CLASS(obj)   (G_TYPE_INSTANCE_GET_CLASS ((obj), RTCOM_TYPE_EL_QUERY, RTComElQueryClass))

typedef struct _RTComElQueryClass RTComElQueryClass;
typedef struct _RTComElQuery RTComElQuery;

#include "rtcom-eventlogger/eventlogger.h"

struct _RTComElQueryClass
{
    GObjectClass parent_class;
};

struct _RTComElQuery
{
    GObject parent_instance;
};

typedef enum
{
    RTCOM_EL_QUERY_GROUP_BY_NONE,
    RTCOM_EL_QUERY_GROUP_BY_CONTACT,
    RTCOM_EL_QUERY_GROUP_BY_UIDS,
    RTCOM_EL_QUERY_GROUP_BY_GROUP
} RTComElQueryGroupBy;

GType rtcom_el_query_get_type(void) G_GNUC_CONST;

RTComElQuery * rtcom_el_query_new(
        RTComEl * el);

void rtcom_el_query_set_is_caching(
        RTComElQuery * query,
        gboolean is_caching);

void rtcom_el_query_set_limit(
        RTComElQuery * query,
        gint limit);

void rtcom_el_query_set_offset(
        RTComElQuery * query,
        gint offset);

void rtcom_el_query_set_group_by(
        RTComElQuery * query,
        RTComElQueryGroupBy group_by);

gboolean rtcom_el_query_refresh(
        RTComElQuery * query);

gboolean rtcom_el_query_prepare(
        RTComElQuery * query,
        ...);

const gchar * rtcom_el_query_get_sql(
        RTComElQuery * query);

const gchar * rtcom_el_query_get_where_clause(
        RTComElQuery * query);

/* Takes an opaque pointer containing reference to sqlite3
 * statement, and returns a key(string)->GValue(int/string) map
 * with the row values. The returned GHashTable can be freed
 * with g_hash_table_destroy(). */
GHashTable *rtcom_el_query_get_row(gpointer stmt);

/* Updates row values. Useful when iterating over a large number
 * of rows as it avoids hash table repeated destruction/creation. */
void rtcom_el_query_update_row(gpointer stmt, GHashTable *row);

G_END_DECLS

#endif

/* vim: set ai et tw=75 ts=4 sw=4: */

---