![]() |
![]() |
![]() |
GNOME Data Access 4.0 manual | ![]() |
---|---|---|---|---|
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).
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.
cols : | 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.
cols : | 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
src : | a GdaDataModel to copy data from |
error : | 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
model : | a GdaDataModelArray object |
row : | |
error : | 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.
model : | the GdaDataModelArray. |
cols : | number of columns for rows this data model should use. |
void gda_data_model_array_clear (GdaDataModelArray *model);
Frees all the rows in model.
model : | the model to clear. |