append_values
Description:
Appends a row to the given data model.
If any value in values
is actually null, then it is considered as a default value. If
values
is null then all values are set to their default value.
Upon errors -1 will be returned and throws will be assigned a Error from the DataModelError domain.
Parameters:
this |
a DataModel object. |
values |
List of Value* representing the row to add. The length must match model's column count. These Value are value-copied (the user is still responsible for freeing them). |
Returns:
the number of the added row, or -1 if an error occurred |