Result
UpdateData
set the value to which an element will be changed
Calling Sequence
Parameters
Description
Examples
result:-UpdateData( index, data )
result
-
Result module
index
string or integer; the column to be updated
data
the new value
UpdateData sets the value that the element stored in the row (indicated by the row cursor) and the column (indicated by index) will be changed to on a call to UpdateRow. The value the element will be changed to is data.
To update a row, set the new values by by calling UpdateData and then submit these updates by calling UpdateRow. Changing the current row discards any values set with UpdateData.
Maple can automatically determine the type of the column and convert data; however, this requires querying the type of the column. To avoid this overhead the type can be specified using an explicit cast. For more information, see conversions.
An element can be set to SQL NULL by passing 'SQLNULL' for data.
Not all Result modules can be updated. Only Result modules representing tables containing data from a single table (no joins) and a column of primary keys are guaranteed to be updatable. Particular JDBC Drivers and databases may allow a wider range of updatable tables and thus Result modules.
Create a Result to be updated.
driver≔DatabaseLoadDriver⁡:
conn≔driver:-OpenConnection⁡url,name,pass:res≔conn:-ExecuteQuery⁡SELECT id,name,number,mass FROM animals:res:-Next⁡
true
Get the current values.
res:-GetData⁡2
fish
res:-GetData⁡3
100
res:-GetData⁡4
0.0100000000000000002
Set the update values.
res:-UpdateData⁡2,chicken;res:-UpdateData⁡3,6;res:-UpdateData⁡4,2.5
The new values are not sent to the database yet.
Update the row.
res:-UpdateRow⁡
Check the values.
chicken
6
2.50000000000000000
See Also
Database
Database[Result]
Database[Result][GotoRow]
Database[Result][Last]
Database[Result][Next]
Database[Result][Previous]
Database[Result][UpdateRow]
Database[usage]
Download Help Document