Parent | Child | Previous | Next

table.UPDATE Function

Syntax

V Update(), Specify the required values in the Update dot variable, then use the following command:<TBL>.UPDATE()

Arguments

Update.fields: Type "N". Specifies how many fields are to be updated.
Update.field1 ... Update.fieldN: Type "C". Fields (1 ... N) containing the names of the fields to be updated.
Expr1 ... ExprN: Type "C". Fields (1 ... N) containing the value or expression used to update the field.

Description

Update all records in table using expressions.

Discussion

The <TBL>.UPDATE() method is a high-level utility used to globally update the records of a specified table. You perform an Update operation on the table referenced by the <TBL> pointer. Each Update operation is defined on a field-by-field basis. Field mappings consists of a Fieldname and an associated Update expression. All of the currently selected records are updated (i.e., the active range, index, or query).

Example

This script is used to update the ON_HAND and STATUS fields in a table for all records that satisfy a filter condition.

tbl = table.open("products")
'Define a query so that only selected records are updated.
query.filter = "TYPE = 'Camping'"
query.order = ""
query.options = ""
indx = tbl.query_create()
update.fields = 2
update.field1 = "ON_HAND"
update.expr1 = "0"
update.field2 = "STATUS"
update.expr2 = " 'Discontinued' "
tbl.update()