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.
| this |
a DataModel object. |
| col |
a valid column number. |
| row |
a valid row number. |
|
a Value containing the value stored in the given position, or null on error (out-of-bound position, etc). |