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:

value (GObject.Value) – a GObject.Value belonging to self (obtained with Gda.Row.get_value()).
error (GLib.Error or None) – the error which lead to the invalidation

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