aboutsummaryrefslogtreecommitdiffstats
path: root/source/lang/api/micros.rst
blob: f12976bcec8f4970839a2c3afb29caed8b84d886 (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
.. highlight:: cpp

.. _lang-micros:

micros()
========

Returns the number of microseconds since the Maple board began running
the current program. This number will overflow (go back to zero),
after approximately 70 minutes.

.. note:: There are 1,000 microseconds in a millisecond, and 1,000,000
   microseconds in a second.

Library Documentation
---------------------

.. doxygenfunction:: micros

Example
-------

::

    unsigned int time;

    void setup() {
    }

    void loop() {
      SerialUSB.print("Time: ");
      time = micros();
      // prints time since program started
      SerialUSB.println(time);
      // wait a second so as not to send massive amounts of data
      delay(1000);
    }

See Also
--------

-  :ref:`millis() <lang-millis>`
-  :ref:`delay() <lang-delay>`
-  :ref:`delayMicroseconds() <lang-delaymicroseconds>`

.. include:: cc-attribution.txt