get_value_at
Description:
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). |