GNOME Data Access manual |
---|
struct GdaDataModel; struct GdaRow; GdaRow* gda_row_new (GdaDataModel *model, gint count); GdaRow* gda_row_new_from_list (GdaDataModel *model, const GList *values); void gda_row_free (GdaRow *row); GdaDataModel* gda_row_get_model (GdaRow *row); gint gda_row_get_number (GdaRow *row); void gda_row_set_number (GdaRow *row, gint number); const gchar* gda_row_get_id (GdaRow *row); void gda_row_set_id (GdaRow *row, const gchar *id); GdaValue* gda_row_get_value (GdaRow *row, gint num); gint gda_row_get_length (GdaRow *row);
GdaRow* gda_row_new (GdaDataModel *model, gint count);
Creates a GdaRow which can hold count GdaValue.
model : | |
count : | |
Returns : | the newly allocated GdaRow. |
GdaRow* gda_row_new_from_list (GdaDataModel *model, const GList *values);
Create a GdaRow from a list of GdaValue's.
model : | |
values : | a list of GdaValue's. |
Returns : | the newly created row. |
void gda_row_free (GdaRow *row);
Deallocates all memory associated to a GdaRow.
row : | the resource to free. |
GdaDataModel* gda_row_get_model (GdaRow *row);
Get the GdaDataModel the given GdaRow belongs to.
row : | a GdaRow. |
Returns : | a GdaDataModel. |
gint gda_row_get_number (GdaRow *row);
Get the number of the given row, that is, its position in its containing data model.
row : | a GdaRow. |
Returns : | the row number, or -1 if there was an error. |
void gda_row_set_number (GdaRow *row, gint number);
Set the row number for the given row.
row : | a GdaRow. |
number : | the new row number. |
const gchar* gda_row_get_id (GdaRow *row);
Return the unique identifier for this row. This identifier is assigned by the different providers, to uniquely identify rows returned to clients. If there is no ID, this means that the row has not been created by a provider, or that it the provider cannot identify it (ie, modifications to it won't take place into the database).
row : | |
Returns : | the unique identifier for this row. |
void gda_row_set_id (GdaRow *row, const gchar *id);
Assign a new identifier to the given row. This function is usually called by providers.
row : | |
id : | New identifier for the row. |
GdaValue* gda_row_get_value (GdaRow *row, gint num);
Gets a pointer to a GdaValue stored in a GdaRow.
This is a pointer to the internal array of values. Don't try to free or modify it!
row : | |
num : | field index. |
Returns : | a pointer to the GdaValue in the position num of row. |
<<< gda-quark-list | GdaSelect >>> |