aboutsummaryrefslogtreecommitdiffstats
path: root/docs/source/lang/modulo.rst
blob: 289fba02985ac80bfb7f299b19d2067edc2e5ef1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
.. highlight:: cpp

.. _lang-modulo:

Modulo Operator (``%``)
=======================

Calculates the `remainder <http://en.wikipedia.org/wiki/Remainder>`_
when one integer is divided by another. It is useful for keeping a
variable within a particular range (e.g.  the size of an array).

Syntax
------

::

    dividend % divisor

Parameters
----------

**dividend**: the number to be divided

**divisor**: the number to divide by

Returns
-------

The remainder of **dividend**\ /\ **divisor**\ .

Examples
--------

::

    int x;
    x = 7 % 5;   // x now contains 2
    x = 9 % 5;   // x now contains 4
    x = 5 % 5;   // x now contains 0
    x = 4 % 5;   // x now contains 4

::

    /* update one value in an array each time through a loop */

    int values[10];
    int i = 0;

    void setup() {
        // no setup necessary
    }

    void loop() {
      values[i] = analogRead(0);
      i = (i + 1) % 10;   // modulo operator makes sure i stays between 0 and 9
    }

Tip
---

The modulo operator does not work on floats.  For that, you can use
the C standard library function `fmod()
<http://sourceware.org/newlib/libm.html#fmod>`_.

See Also
--------

-  :ref:`Arithmetic <lang-arithmetic>`

.. include:: cc-attribution.txt