MUL

Returns the product of two or more inputs.

Signature

     ┌─────────┐
IN1 ─┤         │
IN2 ─┤   MUL   ├─ OUT
IN3 ─┤         │
     └─────────┘

FUNCTION MUL : ANY_NUM
  VAR_INPUT
    IN1 : ANY_NUM;
    IN2 : ANY_NUM;
    (* ... additional inputs ... *)
  END_VAR
END_FUNCTION

The return type matches the input type. MUL accepts SINT, INT, DINT, LINT, USINT, UINT, UDINT, ULINT, REAL, LREAL. Inputs of different numeric types widen to the wider one, which is also the return type; see Type Conversions. The time and date types are covered by the overloads below.

Inputs

Name

Type

Description

IN1

ANY_NUM

The first multiplicand.

IN2

ANY_NUM

The second multiplicand.

Outputs

Name

Type

Description

Return value

ANY_NUM

The product of all inputs. Same type as the inputs.

Description

Returns the product of all inputs. MUL(a, b) is the functional form of the * operator: a * b. Both forms are equivalent, and MUL(a, b, c) is a * b * c.

For integer types, overflow behavior wraps around (modular arithmetic).

Time and date overloads

MUL and the * operator are also defined on the following time and date operands (IEC 61131-3 Table 30). Each combination is the typed function in the last column and computes what it computes.

IN1

IN2

Return value

Same as

TIME

ANY_NUM

TIME

MUL_TIME

The duration comes first: t * 2 is MUL_TIME, but 2 * t is an error.

Each typed function has a long form over LTIME, LDATE, LTIME_OF_DAY and LDATE_AND_TIME (MUL_LTIME), which applies when either operand is of a long type.

Any other combination of types is an error (P4049).

Example

result := MUL(6, 7);      (* result = 42 *)
result := MUL(2, 3, 7);   (* result = 42 *)
result := 6 * 7;          (* result = 42, operator form *)

See Also

  • ADD — addition

  • DIV — division

  • MOD — modulo

References