aboutsummaryrefslogtreecommitdiffstats
path: root/docs/source/arduino/break.rst
blob: 57009c1c56c4c2ef68e75ce89f71dfc1ed403032 (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

.. _arduino-break:

break
=====

``break`` is used to exit from a :ref:`while <arduino-while>`\ ,
:ref:`for <arduino-for>`\ , or :ref:`do/while <arduino-dowhile>` loop,
bypassing the normal loop condition.  It is also used to exit from a
:ref:`switch <arduino-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);
    }