EDataBookCursorSqlite

EDataBookCursorSqlite — The SQLite cursor implementation

Synopsis

#include <libedata-book/libedata-book.h>

struct              EDataBookCursorSqlite;
struct              EDataBookCursorSqliteClass;
EDataBookCursor *   e_data_book_cursor_sqlite_new       (EBookBackend *backend,
                                                         EBookSqlite *ebsql,
                                                         const gchar *revision_key,
                                                         const EContactField *sort_fields,
                                                         const EBookCursorSortType *sort_types,
                                                         guint n_fields,
                                                         GError **error);

Description

This cursor implementation can be used with any backend which stores contacts using EBookSqlite.

Details

struct EDataBookCursorSqlite

struct EDataBookCursorSqlite {
	EDataBookCursor parent;
	EDataBookCursorSqlitePrivate *priv;
};

An opaque handle for the SQLite cursor instance.

Since 3.12


struct EDataBookCursorSqliteClass

struct EDataBookCursorSqliteClass {
	EDataBookCursorClass parent;
};

The SQLite cursor class structure.

Since 3.12


e_data_book_cursor_sqlite_new ()

EDataBookCursor *   e_data_book_cursor_sqlite_new       (EBookBackend *backend,
                                                         EBookSqlite *ebsql,
                                                         const gchar *revision_key,
                                                         const EContactField *sort_fields,
                                                         const EBookCursorSortType *sort_types,
                                                         guint n_fields,
                                                         GError **error);

Creates an EDataBookCursor and implements all of the cursor methods using the delegate ebsql object.

This is a suitable cursor type for any backend which stores its contacts using the EBookSqlite object.

backend :

the EBookBackend creating this cursor

ebsql :

the EBookSqlite object to base this cursor on

revision_key :

The key name to consult for the current overall contacts database revision

sort_fields :

an array of EContactFields as sort keys in order of priority. [array length=n_fields]

sort_types :

an array of EBookCursorSortTypes, one for each field in sort_fields. [array length=n_fields]

n_fields :

the number of fields to sort results by.

error :

a return location to story any error that might be reported.

Returns :

A newly created EDataBookCursor, or NULL if cursor creation failed. [transfer full]

Since 3.12