## GdaRow

GdaRow — Individual row of a GdaDataModelArray object

## Stability Level

Stable, unless otherwise indicated

## Synopsis

    struct              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

### struct GdaRow

    struct 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

## See Also

GdaDataModelArray