Gda.Row

g GObject.Object GObject.Object Gda.Row Gda.Row GObject.Object->Gda.Row

Subclasses:

None

Methods

Inherited:

GObject.Object (37)

Structs:

GObject.ObjectClass (5)

class

new (count)

get_length ()

get_value (num)

invalidate_value (value)

invalidate_value_e (value, error)

value_is_valid (value)

value_is_valid_e (value)

Virtual Methods

Inherited:

GObject.Object (7)

Properties

Name

Type

Flags

Short Description

nb-values

int

w

Number of values in the row

Signals

Inherited:

GObject.Object (1)

Fields

Inherited:

GObject.Object (1)

Name

Type

Access

Description

object

GObject.Object

r

Class Details

class Gda.Row(**kwargs)
Bases:

GObject.Object

Abstract:

No

Structure:

Gda.RowClass

classmethod new(count)
Parameters:

count (int) – number of GObject.Value in the new Gda.Row.

Returns:

a newly allocated Gda.Row object.

Return type:

Gda.Row

Creates a Gda.Row which can hold count GObject.Value values.

get_length()
Returns:

the number of columns that the self has.

Return type:

int

get_value(num)
Parameters:

num (int) – field index.

Returns:

a pointer to the GObject.Value in the position num of self.

Return type:

GObject.Value or None

Gets a pointer to a GObject.Value stored in a Gda.Row.

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).

invalidate_value(value)
Parameters:

value (GObject.Value) – a GObject.Value belonging to self (obtained with Gda.Row.get_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.

invalidate_value_e(value, error)
Parameters:

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.

New in version 4.2.10.

value_is_valid(value)
Parameters:

value (GObject.Value) – a GObject.Value belonging to self (obtained with Gda.Row.get_value()).

Returns:

True if value is valid

Return type:

bool

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.

value_is_valid_e(value)
Parameters:

value (GObject.Value) – a GObject.Value belonging to self (obtained with Gda.Row.get_value()).

Raises:

GLib.Error

Returns:

True if value is valid

Return type:

bool

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.

New in version 4.2.10.

Property Details

Gda.Row.props.nb_values
Name:

nb-values

Type:

int

Default Value:

1

Flags:

WRITABLE

Number of values in the row