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.

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 (modifying is reserved to database provider's implementations).

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

Number of values in the row.

Allowed values: >= 1

Default value: 1