diff options
Diffstat (limited to 'docs/source/lang/api/millis.rst')
| -rw-r--r-- | docs/source/lang/api/millis.rst | 52 | 
1 files changed, 52 insertions, 0 deletions
diff --git a/docs/source/lang/api/millis.rst b/docs/source/lang/api/millis.rst new file mode 100644 index 0000000..b6fbf55 --- /dev/null +++ b/docs/source/lang/api/millis.rst @@ -0,0 +1,52 @@ +.. highlight:: cpp + +.. _lang-millis: + +millis() +======== + +Returns the number of milliseconds since the Maple board began running +the current program. This number will overflow (go back to zero) after +approximately 50 days. + +Library Documentation +--------------------- + +.. doxygenfunction:: millis + +Example +------- + +The following time prints the value returned by ``millis()`` roughly +once per second:: + +    unsigned int time; + +    void setup() { +    } + +    void loop() { +      SerialUSB.print("Time: "); +      time = millis(); +      // prints time since program started +      SerialUSB.println(time); + +      // wait a second so as not to send massive amounts of data +      delay(1000); +    } + +Tip +--- + +Since the return value for ``millis()`` is an :ref:`unsigned long +<lang-unsignedlong>`, overflow errors may occur if you try to do math +with other data types, such as :ref:`chars <lang-char>`. + +See Also +-------- + +- :ref:`micros <lang-micros>` +- :ref:`delay <lang-delay>` +- :ref:`delayMicroseconds <lang-delaymicroseconds>` + +.. include:: /arduino-cc-attribution.txt  | 
