Home
References
Language References

random()

Descrição

A função random() gera números pseudoaleatórios.

Sintaxe

random(max)

random(min, max)

Parâmetros

  • min - menor limite do valor aleatório, inclusivo e opcional (long)
  • max - maior limite do valor aleatório, exclusivo (long)

Retorna

Um número inteiro aleatório entre min e max-1 (long) .

Código de exemplo

O código abaixo gera números aleatórios e os imprime na porta serial.

long randNumber; void setup() { Serial.begin(9600); // Se o pino de entrada analógica 0 é deixado desconectado, // o ruído aleatório analógico irá causar a chamada de randomSeed() // gerar sementes aleatórias diferentes cada vez que o sketch roda. // randomSeed() basicamente "embaralha" a função random(). randomSeed(analogRead(0)); } void loop() { // imprime um número aleatório entre 0 e 299 randNumber = random(300); Serial.print("A random number from 0 to 299: "); Serial.println(randNumber); // imprime um valor aleatório entre 10 e 19 randNumber = random(10, 20); Serial.print("A random number from 10 to 19: "); Serial.println(randNumber); delay(1000); }
  • The result on Serial Monitor:
COM6
Send
A random number from 0 to 299: 52 A random number from 10 to 19: 15 A random number from 0 to 299: 165 A random number from 10 to 19: 15 A random number from 0 to 299: 276 A random number from 10 to 19: 17 A random number from 0 to 299: 244 A random number from 10 to 19: 13 A random number from 0 to 299: 216 A random number from 10 to 19: 15 A random number from 0 to 299: 91
Autoscroll Show timestamp
Clear output
9600 baud  
Newline  

※ Notas e Advertências:

Se é importante que uma sequência de valores gerados por random() seja diferente em execuções subsequentes de um sketch, use randomSeed() para inicializar o gerador de números aleatórios com uma entrada significantemente aleatória, como analogRead() em um pino desconectado.

Por outro lado, pode ser ocasionalmente útil usar sequências pseudoaleatórias exatamente repetidas. Isso pode ser conseguido chamando-se randomSeed() com um número fixo, antes de começar a usar a sequência aleatória.

O parâmetro max deve ser escolhido de acordo com o tipo de dado da variável na qual o valor será guardado. De qulquer forma, o valor máximo absoluto é limitado pela natureza long (32 bit - 2,147,483,647) do valor gerado. Escolher um valor max maior que isso não irá gerar erros durante a compilação, mas durante a execução do sketch, os números gerados irão se comportar de forma impredizível.

Ver Também

※ ARDUINO BUY RECOMMENDATION

Arduino UNO R3
Arduino Starter Kit
Please note: These are Amazon affiliate links. If you buy the components through these links, We will get a commission at no extra cost to you. We appreciate it.

※ OUR MESSAGES

DISCLOSURE
ArduinoGetStarted.com is a participant in the Amazon Services LLC Associates Program, an affiliate advertising program designed to provide a means for sites to earn advertising fees by advertising and linking to Amazon.com, Amazon.it, Amazon.fr, Amazon.co.uk, Amazon.ca, Amazon.de, Amazon.es, Amazon.nl, Amazon.pl and Amazon.se
The Arduino Reference text is licensed under a Creative Commons Attribution-Share Alike 3.0 License. The content is modified based on Official Arduino References by: adding more example codes and output, adding more notes and warning, rewriting some parts, and re-formating
Email: ArduinoGetStarted@gmail.com