![]() |
![]() |
![]() |
GNOME Data Access 4 manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties |
GdaDataModelArrayGdaDataModelArray — An implementation of GdaDataModel based on a GArray. |
GdaDataModelArray; GdaDataModelArrayClass; GdaDataModelArrayPrivate; GdaDataModel * gda_data_model_array_new (gint cols); GdaDataModel * gda_data_model_array_new_with_g_types (gint cols, ...); GdaDataModelArray * gda_data_model_array_copy_model (GdaDataModel *src, GError **error); GdaRow * gda_data_model_array_get_row (GdaDataModelArray *model, gint row, GError **error); void gda_data_model_array_set_n_columns (GdaDataModelArray *model, gint cols); void gda_data_model_array_clear (GdaDataModelArray *model);
The GdaDataModelArray object is a data model which internally uses a GArray to index all its rows (represented as GdaRow objects). In this data model, all the data is stored in memory, which can be a memory limitation if the number of rows is huge.
This type of data model is easy to use to store some temporary data, and has a random access mode (any value can be accessed at any time without the need for an iterator).
typedef struct { GObjectClass parent_class; /* Padding for future expansion */ void (*_gda_reserved1) (void); void (*_gda_reserved2) (void); void (*_gda_reserved3) (void); void (*_gda_reserved4) (void); } GdaDataModelArrayClass;
GdaDataModel * gda_data_model_array_new (gint cols);
Creates a new GdaDataModel object without initializing the column
types. Using gda_data_model_array_new_with_g_types()
is usually better.
|
number of columns for rows in this data model. |
Returns : |
a pointer to the newly created GdaDataModel. |
GdaDataModel * gda_data_model_array_new_with_g_types (gint cols, ...);
Creates a new GdaDataModel object with the column types as specified.
|
number of columns for rows in this data model. |
|
types of the columns of the model to create as GType, as many as indicated by cols
|
Returns : |
a pointer to the newly created GdaDataModel. |
GdaDataModelArray * gda_data_model_array_copy_model (GdaDataModel *src, GError **error);
Makes a copy of src
into a new GdaDataModelArray object
|
a GdaDataModel to copy data from |
|
a place to store errors, or NULL
|
Returns : |
a new data model, or NULL if an error occurred
|
GdaRow * gda_data_model_array_get_row (GdaDataModelArray *model, gint row, GError **error);
Get a pointer to a row in model
|
a GdaDataModelArray object |
|
row number (starting from 0) |
|
a place to store errors, or NULL
|
Returns : |
the GdaRow, or NULL if an error occurred
|
void gda_data_model_array_set_n_columns (GdaDataModelArray *model, gint cols);
Sets the number of columns for rows inserted in this model.
cols
must be greated than or equal to 0.
Also clears model
's contents.
|
the GdaDataModelArray. |
|
number of columns for rows this data model should use. |
void gda_data_model_array_clear (GdaDataModelArray *model);
Frees all the rows in model
.
|
the model to clear. |