aboutsummaryrefslogtreecommitdiffstats
path: root/docs/source/lang/cpp/break.rst
blob: f367b99f340c63c16587f94162843a7aadca4f5a (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
.. highlight:: cpp

.. _lang-break:

``break``
=========

``break`` is used to exit from a :ref:`while <lang-while>`\ ,
:ref:`for <lang-for>`\ , or :ref:`do/while <lang-dowhile>` loop,
bypassing the normal loop condition.  It is also used to exit from a
:ref:`switch <lang-switchcase>` statement.


Example
-------

::

    for (x = 0; x < 255; x ++)
    {
        digitalWrite(PWMpin, x);
        sens = analogRead(sensorPin);
        if (sens > threshold){      // bail out on sensor detect
           x = 0;
           // this line of code means that we'll immediately exit
           // from the "for" loop:
           break;
        }
        delay(50);
    }

.. include:: /arduino-cc-attribution.txt