GdaDataModel
Basic data model class
A #GdaDataMode represents an array of values organized in rows and columns. All the data in the same
column have the same type, and all the data in each row have the same semantic meaning. The #GdaDataModel is
actually an interface implemented by other objects to support various kinds of data storage and operations.
Depending on the real implementation, the contents of data models may be modified by the user using functions
provided by the model. The actual operations a data model permits can be known using the
gda_data_model_get_access_flags() method.
Again, depending on the real implementation, data retreiving can be done either accessing direct random
values located by their row and column, or using a #GdaDataModelIter cursor, or both. Use the
gda_data_model_get_access_flags() method to know how the data model can be accessed. Note that a #GdaDatamodel
which can be accessed in a random way can also be accessed using cursors (and several cusrors may be used at the same
time), whereas data model which can only be accessed using cursors can only have one cursor for iterating.
Random access data models are easier to use since picking a value is very simple using the gda_data_model_get_value_at(),
but consume more memory since all the accessible values must generally be present in memory even if they are not used.
Thus if a data model must handle large quantities of data, it is generally wiser to use a data model which can be
only accessed using a cursor.
As a side note there are also data models which wrap other data models such as:
The #GdaDataProxy data model which stores temporary modifications and shows only some
parts of the wrapped data model
The #GdaDataAccessWrapper data model which offers a memory-efficient random access on top of a
wrapped cursor based access data model
@gdadatamodel: the object which received the signal.
@arg1:
@gdadatamodel: the object which received the signal.
@arg1:
@gdadatamodel: the object which received the signal.
@arg1:
@GDA_DATA_MODEL_ACCESS_RANDOM:
@GDA_DATA_MODEL_ACCESS_CURSOR_FORWARD:
@GDA_DATA_MODEL_ACCESS_CURSOR_BACKWARD:
@GDA_DATA_MODEL_ACCESS_INSERT:
@GDA_DATA_MODEL_ACCESS_UPDATE:
@GDA_DATA_MODEL_ACCESS_DELETE:
@GDA_DATA_MODEL_ACCESS_WRITE:
@GDA_DATA_MODEL_HINT_START_BATCH_UPDATE:
@GDA_DATA_MODEL_HINT_END_BATCH_UPDATE:
@GDA_DATA_MODEL_HINT_REFRESH:
@GDA_DATA_MODEL_IO_DATA_ARRAY_XML:
@GDA_DATA_MODEL_IO_TEXT_SEPARATED:
@model:
@model:
@row:
@model:
@row:
@model:
@row:
@model:
@model:
@model:
@Returns:
@model:
@Returns:
@model:
@Returns:
@model:
@col:
@Returns:
@model:
@col:
@Returns:
@model:
@col:
@title:
@model:
@col:
@row:
@Returns:
@model:
@col:
@row:
@value:
@error:
@Returns:
@model:
@Returns:
@row:
@model:
@iter:
@row:
@Returns:
@model:
@iter:
@Returns:
@model:
@iter:
@Returns:
@model:
@values:
@error:
@Returns:
@model:
@error:
@Returns:
@row:
@values:
@model:
@row:
@error:
@Returns:
@model:
@values:
@cols_index:
@Returns:
@model:
@hint:
@hint_value:
@model:
@format:
@cols:
@nb_cols:
@options:
@Returns:
@model:
@format:
@file:
@cols:
@nb_cols:
@options:
@error:
@Returns:
@to:
@from:
@cols_trans:
@error:
@Returns:
@model:
@string:
@cols_trans:
@options:
@error:
@Returns:
@format:
@cols:
@nb_cols:
@model:
@file:
@cols_trans:
@options:
@error:
@Returns:
@format:
@cols:
@nb_cols:
@model:
@to_stream:
@model:
@Returns: