get_value_at


Description:

public unowned Value? get_value_at (int col, int row) throws Error

Retrieves the data stored in the given position (identified by the col and row parameters) on a data model.

Upon errors null will be returned and throws will be assigned a Error from the DataModelError domain.

This is the main function for accessing data in a model which allows random access to its data. To access data in a data model using a cursor, use a DataModelIter object, obtained using create_iter.

Note1: the returned Value must not be modified directly (unexpected behaviours may occur if you do so).

Note2: the returned value may become invalid as soon as any Libgda part is executed again, which means if you want to keep the value, a copy must be made, however it will remain valid as long as the only Libgda usage is calling get_value_at for different values of the same row.

If you want to modify a value stored in a DataModel, use the set_value_at or set_values methods.

Upon errors null will be returned and throws will be assigned a Error from the DataModelError domain.

Parameters:

this

a DataModel object.

col

a valid column number.

row

a valid row number.

Returns:

a Value containing the value stored in the given position, or null on error (out-of-bound position, etc).