# Mod and Modulus (Float functions)

Jump to navigation
Jump to search

Remainder of integer division (Float class)

The `Mod` and `Modulus` intrinsic functions return the remainder from the division of the method object by the method argument. The numbers to be divided are first rounded to an integer, including zero, so the remainder is always an integer or zero.

`Mod` is a synonym for `Modulus`.

## Syntax

%number = float:Mod( divisor)

%number = float:Modulus( divisor)

### Syntax terms

%number | A variable to receive the integral remainder of the quotient of float / divisor. |
---|---|

float | A Float value to be divided by the method argument, divisor. |

divisor | A non-zero numeric value. A divisor with a value of 0, or a value that rounds down to 0, causes a request cancellation. |

## Usage notes

`Mod`/`Modulus`are available as of`Sirius Mods`Version 7.3.

## Examples

- The following statement returns to
`%z`

the remainder from the division of the number in`%x`

(rounded) by the number in`%y`

(rounded):%z = %x:mod(%y)

- The following statement returns
`-1`

to`%z`

:%z = -191.4:mod(2.0)

- The following displays the quotient and remainder when dividing
`9997`

by`7`

:begin %dividend is float %divisor is float %dividend = 9997 %divisor = 7

`printtext`{~} = {%dividend:div(%divisor)} printText {~} = {%dividend:mod(%divisor)} endThe result is:

%dividend:div(%divisor) = 1428 %dividend:mod(%divisor) = 1

## See also

- The
`Div`function returns the integral quotient of a division.