aboutsummaryrefslogtreecommitdiffstats
path: root/docs/source/arduino/random.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/source/arduino/random.rst')
-rw-r--r--docs/source/arduino/random.rst92
1 files changed, 0 insertions, 92 deletions
diff --git a/docs/source/arduino/random.rst b/docs/source/arduino/random.rst
deleted file mode 100644
index 44f122a..0000000
--- a/docs/source/arduino/random.rst
+++ /dev/null
@@ -1,92 +0,0 @@
-.. _arduino-random:
-
-random()
-========
-
-Description
------------
-
-The random function generates pseudo-random numbers.
-
-
-
-Syntax
-------
-
-random(max)
-random(min, max)
-
-
-
-Parameters
-----------
-
-min - lower bound of the random value, inclusive *(optional)*
-
-
-
-max - upper bound of the random value, exclusive
-
-
-
-Returns
--------
-
-a random number between min and max-1 (*long*)
-
-
-
-Note:
------
-
-If it is important for a sequence of values generated by random()
-to differ, on subsequent executions of a sketch, use randomSeed()
-to initialize the random number generator with a fairly random
-input, such as analogRead() on an unconnected pin.
-
-
-
-Conversely, it can occasionally be useful to use pseudo-random
-sequences that repeat exactly. This can be accomplished by calling
-randomSeed() with a fixed number, before starting the random
-sequence.
-
-
-
-Example
--------
-
-::
-
- long randNumber;
-
- void setup(){
- Serial.begin(9600);
-
- // if analog input pin 0 is unconnected, random analog
- // noise will cause the call to randomSeed() to generate
- // different seed numbers each time the sketch runs.
- // randomSeed() will then shuffle the random function.
- randomSeed(analogRead(0));
- }
-
- void loop() {
- // print a random number from 0 to 299
- randNumber = random(300);
- Serial.println(randNumber);
-
- // print a random number from 10 to 19
- randNumber = random(10, 20);
- Serial.println(randNumber);
-
- delay(50);
- }
-
-
-
-See also
---------
-
-
-- `randomSeed <http://arduino.cc/en/Reference/RandomSeed>`_\ ()
-