random()¶
The random()
function generates pseudo-random numbers.
Library Documentation¶
-
random
(long max)¶ Same as a call to
random(0, max)
.
-
random
(long min, long max)¶ Generate a pseudo-random number with given lower and upper bounds.
Parameters
min
- Lower bound on the returned value, inclusivemax
- Upper bound on the returned value, exclusive
Returns: A pseudo-random number in the range [min, max).
Discussion¶
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 pseudorandom
sequences that repeat exactly. This can be accomplished by calling
randomSeed()
with a fixed number, before starting the random
sequence.
Example¶
The following sketch initializes the random seed based on an ADC reading of pin 0. If this pin is unconnected, the Sketch should print different values to the serial port monitor each time it is run:
long randNumber;
void setup() {
pinMode(0, INPUT_ANALOG);
randomSeed(analogRead(0));
}
void loop() {
randNumber = random(300);
SerialUSB.println(randNumber);
delay(50);
}
See Also¶
License and Attribution
Portions of this page were adapted from the Arduino Reference Documentation, which is released under a Creative Commons Attribution-ShareAlike 3.0 License.