add

Typecommand
DictionaryLCS
LibraryLiveCode Script
Syntax
add <number> to [<chunk> of] <container>
add {<number> | <array>} to <arrayContainer>
Summary

Adds a number to a container and places the resulting value in the container.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server
Parameters
NameTypeDescription
number

An expression that evaluates to a number.

chunk

A chunk expression specifying a portion of the container.

container

A field, button, or variable, or the message box.

array

An array variable each of whose elements is a number.

arrayContainer

An array variable each of whose elements is a number.

Example
add 7 to field 1
local tSummaryOfInventory
add field "New" to tSummaryOfInventory
local qty, price, tOrder
add (qty * price) to last line of tOrder
# Assume the following handler in a button, along with
# field "list1" and field "list2" each containing 
# an equal number of return-separated numerals.
# Field "added" is empty.
on mouseUp
    local tNumList1, tNumList2
    put fld "list1" into tNumList1
    put fld "list2" into tNumList2
    split tNumList1 by return
    split tNumList2 by return
    add tNumList2 to tNumList1
    combine tNumList1 by row
    put tNumList1 into fld "added"
end mouseUp
RelatedKeyword: element
Property: numberFormat
Command: combine, multiply, split, union
Function: sum, value
Glossary: array, command, container, element, evaluate, expression, format, property, math operation
Object: button, field
Description

Use the add command to add a number to a container or a portion of a container, or to add two arrays containing numbers.

The contents of the container (or the chunk of the container) must be a number or an expression that evaluates to a number.

If a number is added to an arrayContainer, the number is added to each element. If an array is added to an arrayContainer, both arrays must have the same number of elements and the same dimension, and each element in the array is added to the corresponding element of the arrayContainer.

If the container or an element of the arrayContainer is empty, the add command treats its contents as zero. If container is a field or button, the format of the sum is determined by the numberFormat property.

If a math operation on finite inputs produces a non-finite output, an execution error is thrown. See math operations for more information.

Tagsmath