Top |
GdaRowGdaRow — Individual row of a GdaDataModelArray object |
Functions
GdaRow * | gda_row_new () |
gint | gda_row_get_length () |
GValue * | gda_row_get_value () |
void | gda_row_invalidate_value () |
void | gda_row_invalidate_value_e () |
gboolean | gda_row_value_is_valid () |
gboolean | gda_row_value_is_valid_e () |
Description
The GdaDataModelArray object uses GdaRow to store each row of data. Each GdaRow has the same number of GValue values (equal to the number of columns of the data model).
As a side note, the GdaRow object is also used internally by the implementation of the data models returned when executing a SELECT statement.
Functions
gda_row_get_value ()
GValue * gda_row_get_value (GdaRow *row
,gint num
);
Gets a pointer to a GValue stored in a GdaRow.
This is a pointer to the internal array of values. Don't try to free or modify it (modifying is reserved to database provider's implementations).
gda_row_invalidate_value ()
void gda_row_invalidate_value (GdaRow *row
,GValue *value
);
Marks value
as being invalid. This method is mainly used by database
providers' implementations to report any error while reading a value from the database.
gda_row_invalidate_value_e ()
void gda_row_invalidate_value_e (GdaRow *row
,GValue *value
,GError *error
);
Marks value
as being invalid. This method is mainly used by database
providers' implementations to report any error while reading a value from the database.
Parameters
row |
a GdaRow |
|
value |
a GValue belonging to |
|
error |
the error which lead to the invalidation. |
[allow-none][transfer full] |
Since: 4.2.10
gda_row_value_is_valid ()
gboolean gda_row_value_is_valid (GdaRow *row
,GValue *value
);
Tells if value
has been marked as being invalid by gda_row_invalidate_value()
.
This method is mainly used by database
providers' implementations to report any error while reading a value from the database.
gda_row_value_is_valid_e ()
gboolean gda_row_value_is_valid_e (GdaRow *row
,GValue *value
,GError **error
);
Tells if value
has been marked as being invalid by gda_row_invalidate_value()
.
This method is mainly used by database
providers' implementations to report any error while reading a value from the database.
Parameters
row |
a GdaRow. |
|
value |
a GValue belonging to |
|
error |
a place to store the invalid error, or |
[allow-none] |
Since: 4.2.10
Property Details
The “nb-values”
property
“nb-values” gint
Number of values in the row.
Flags: Write
Allowed values: >= 1
Default value: 1