multiply

Multiplies a number by a container and places the resulting value in the container.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

multiply [chunk of] container by number

# Params

- chunk : A chunk expression specifying a portion of the container. - container : A field, button, or variable, or the message box. - number : Any expression that evaluates to a number. - arrayContainer : An array variable each of whose elements is a number. - array :

# Examples

multiply field 17 by it

multiply yearlyTotals by yearlyPercentages

multiply line thisLine of myVariable by theFactor

# Description

Use the multiply command to multiply a container or a portion of a container by a number, or to multiply 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 an arrayContainer is multiplied by a number, each element is multiplied by the number. If an arrayContainer is multiplied by an array, both arrays must have the same number of elements and the same dimension, and each element in the arrayContainer is multiplied by the corresponding element of the array.

If the container or an element of the arrayContainer is empty, the multiply command treats its contents as zero.

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

# Tags

math,

# See

- **keyword:** field, element, button - **operator:** [[*]] - **property:** numberFormat - **command:** add, divide, subtract - **function:** format, value, matrixMultiply - **glossary:** property, element, container, expression, array, evaluate, command, math operation