UpdateData - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


Result

  

UpdateData

  

set the value to which an element will be changed

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

result:-UpdateData( index, data )

Parameters

result

-

Result module

index

-

string or integer; the column to be updated

data

-

the new value

Description

• 

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.

Examples

Create a Result to be updated.

driverDatabaseLoadDriver:

conndriver:-OpenConnectionurl,name,pass:resconn:-ExecuteQuerySELECT id,name,number,mass FROM animals:res:-Next

true

(1)

Get the current values.

res:-GetData2

fish

(2)

res:-GetData3

100

(3)

res:-GetData4

0.0100000000000000002

(4)

Set the update values.

res:-UpdateData2,chicken;res:-UpdateData3,6;res:-UpdateData4,2.5

The new values are not sent to the database yet.

res:-GetData2

fish

(5)

res:-GetData3

100

(6)

res:-GetData4

0.0100000000000000002

(7)

Update the row.

res:-UpdateRow

Check the values.

res:-GetData2

chicken

(8)

res:-GetData3

6

(9)

res:-GetData4

2.50000000000000000

(10)

See Also

Database

Database[Result]

Database[Result][GotoRow]

Database[Result][Last]

Database[Result][Next]

Database[Result][Previous]

Database[Result][UpdateRow]

Database[usage]