GdaDataModelBdb

GdaDataModelBdb — GdaDataModel to access Berkeley DB database contents

Stability Level

Stable, unless otherwise indicated

Properties

gchar * db-name Read / Write / Construct Only
gchar * filename Read / Write / Construct Only

Types and Values

Object Hierarchy

    GObject
    ╰── GdaDataModelBdb

Implemented Interfaces

GdaDataModelBdb implements GdaDataModel.

Description

The GdaDataModelBdb object allows to access the contents of a Berkeley DB database as a GdaDataModel object.

By default the resulting GdaDataModel contains only two columns (named "key" and "data") of type GDA_TYPE_BINARY, but this object can be subclassed to convert the key or data part of a BDB record into several columns (implement the create_key_columns(), create_data_columns(), get_key_part(), and get_data_part() virtual methods).

Note: this type of data model is available only if the Berkeley DB library was found at compilation time.

Functions

gda_data_model_bdb_new ()

GdaDataModel *
gda_data_model_bdb_new (const gchar *filename,
                        const gchar *db_name);

Creates a new GdaDataModel object to access the contents of the Berkeley DB file file , for the database db_name if not NULL

Parameters

filename

name of the file containing the database

 

db_name

the name of the database within filename , or NULL.

[allow-none]

Returns

a new GdaDataModel.

[transfer full]


gda_data_model_bdb_get_errors ()

const GSList *
gda_data_model_bdb_get_errors (GdaDataModelBdb *model);

Get the list of errors which have occurred while using model

Parameters

model

a GdaDataModelBdb object

 

Returns

a read-only list of GError pointers, or NULL if no error has occurred.

[element-type GError][transfer none]


gda_data_model_bdb_clean_errors ()

void
gda_data_model_bdb_clean_errors (GdaDataModelBdb *model);

Reset the list of errors which have occurred while using model

Parameters

model

a GdaDataModelBdb object

 

Types and Values

struct GdaDataModelBdb

struct GdaDataModelBdb;

struct GdaDataModelBdbClass

struct GdaDataModelBdbClass {
	GObjectClass            parent_class;

	/* virtual methods */
	GSList                *(*create_key_columns)  (GdaDataModelBdb *model);
	GSList                *(*create_data_columns) (GdaDataModelBdb *model);
	GValue                *(*get_key_part)        (GdaDataModelBdb *model, 

						       gpointer data, gint length, gint part);
	GValue                *(*get_data_part)       (GdaDataModelBdb *model,
						       gpointer data, gint length, gint part);
	gboolean               (*update_key_part)     (GdaDataModelBdb *model,
						       gpointer data, gint length, gint part, 
						       const GValue *value, GError **error);
	gboolean               (*update_data_part)    (GdaDataModelBdb *model,
						       gpointer data, gint length, gint part, 
						       const GValue *value, GError **error);
};

GdaDataModelBdbPrivate

typedef struct _GdaDataModelBdbPrivate GdaDataModelBdbPrivate;

Property Details

The “db-name” property

  “db-name”                  gchar *

Name of the database.

Flags: Read / Write / Construct Only

Default value: NULL


The “filename” property

  “filename”                 gchar *

DB file.

Flags: Read / Write / Construct Only

Default value: NULL

See Also

GdaDataModel