GdaDataModelArray's rows

GdaDataModelArray's rows — Row for a GdaDataModelArray object

Synopsis

                    GdaRow;
GdaRow*             gda_row_new                         (gint count);
gint                gda_row_get_length                  (GdaRow *row);
GValue*             gda_row_get_value                   (GdaRow *row,
                                                         gint num);

Object Hierarchy

  GObject
   +----GdaRow

Properties

  "nb-values"                gint                  : Write

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.

Details

GdaRow

typedef struct _GdaRow GdaRow;


gda_row_new ()

GdaRow*             gda_row_new                         (gint count);

Creates a GdaRow which can hold count GValue values.

The caller of this function is the only owner of a reference to the newly created GdaRow object, even if model is not NULL (it is recommended to pass NULL as the model argument if this function is not called from within a GdaDataModel implementation).

count : number of GValue in the new GdaRow.
Returns : a newly allocated GdaRow object.

gda_row_get_length ()

gint                gda_row_get_length                  (GdaRow *row);

row : a GdaRow.
Returns : the number of columns that the row has.

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!

row : a GdaRow
num : field index.
Returns : a pointer to the GValue in the position num of row.

Property Details

The "nb-values" property

  "nb-values"                gint                  : Write

Allowed values: >= 1

Default value: 1