Predefinição:Rand/doc
![]() | Esta é uma subpágina de documentação para a Predefinição:Rand. Ela contém informações sobre o seu uso, categorias, bem como todo o conteúdo que não faz parte da predefinição original. |
Esta predefinição gera um pseudo-aleatório inteiro entre 0 e count -1. Este número é baseado no número de segundos desde 1 de janeiro de 1970 (função do mediawiki {{#time:U}}, do qual se tira o módulo em relação à variável count (default = 100).
Uso
{{Rand|
count|
seed|
prime}}
- Todos parâmetros são opcionais e tem um valor default. Eles devem ser inteiros. Eles não devem ser passados através de count = n (ou seja, {{Rand|count=10}}, mas diretamente, na forma {{Rand|10}}
- O primeiro parâmetro, count, dá o intervalo do resultado final, que vai de 0 a count-1. O seu valor default é 100, e este parâmetro não pode ser zero.
- Os parâmetros seed e prime tem por finalidade fazer uma transformação afim do número de segundos desde 1 de janeiro de 1970, e devem ser usados para que, em uma página com vários argumentos aleatórios, estes assumam valores diferentes. É conveniente que o parâmetro multiplicativo prime seja relativamente primo com o parâmetro count, caso contrário o resultado final excluirá alguns números no intervalo 0 - count-1.
- Os defaults de prime e seed são, respectivamente, 67 e 7. Muito cuidado ao gerar números aleatórios em que count seja um múltiplo de 67. Nestes casos, deve-se alterar o valor de prime.
Exemplos de números gerados entre 0 e 999
{{Rand|1000}}
= 174{{Rand|1000|6}}
= 173{{Rand|1000|5}}
= 172{{Rand|1000|4}}
= 171{{Rand|1000|3}}
= 170{{Rand|1000|2}}
= 169{{Rand|1000|1}}
= 168{{Rand|1000|0}}
= 167
variando o valor de prime
{{Rand|1000|1|17}}
= 118{{Rand|1000|1|19}}
= 720{{Rand|1000|1|23}}
= 924{{Rand|1000|1|29}}
= 730{{Rand|1000|1|31}}
= 332{{Rand|1000|1|37}}
= 138{{Rand|1000|1|41}}
= 342{{Rand|1000|1|43}}
= 944{{Rand|1000|1|47}}
= 148{{Rand|1000|1|51}}
= 352{{Rand|1000|1|53}}
= 954{{Rand|1000|1|59}}
= 760{{Rand|1000|1|61}}
= 362{{Rand|1000|1|67}}
= 168{{Rand|1000|1|71}}
= 372{{Rand|1000|1|73}}
= 974{{Rand|1000|1|79}}
= 780
Nota:
- Variar seed de forma linear mantendo o mesmo count gera números em sequência cíclica (por exemplo, se count for 5, geraria 3,4,0,1,2,3,4,0, ...);
- Variar prime (mas mantendo prime sempre relativamente primo a count) gera números diferentes, mas a sequência costuma ter pouca variabilidade, sendo quase determinística;
- Por construção, se count for par, então, mesmo variando prime, a sequência terá a mesma paridade. Em alguns casos, será constante.
- Duas invocações de {{Rand}} na mesma página, mas com mesmos parâmetros, gerarão o mesmo valor.
Exemplos das Notas
sequências cíclicas, variando seed:
{{Rand|100|1|67}}
= 68{{Rand|100|2|67}}
= 69{{Rand|100|3|67}}
= 70{{Rand|100|4|67}}
= 71{{Rand|100|5|67}}
= 72
sequências com mesma paridade:
{{Rand|10|1|1}}
= 2{{Rand|10|1|3}}
= 4{{Rand|10|1|5}}
= 6{{Rand|10|1|7}}
= 8{{Rand|10|1|9}}
= 0{{Rand|10|1|11}}
= 2{{Rand|10|1|13}}
= 4
a partir do segundo ou terceiro, os valores se repetem:
{{Rand|9|1|67}}
= 0{{Rand|9|1|70}}
= 6{{Rand|9|1|73}}
= 3{{Rand|9|1|76}}
= 0{{Rand|9|1|79}}
= 6{{Rand|9|1|82}}
= 3{{Rand|9|1|85}}
= 0
problema não é resolvido variando-se seed:
{{Rand|9|1|67}}
= 0{{Rand|9|2|70}}
= 7{{Rand|9|3|73}}
= 5{{Rand|9|4|76}}
= 3{{Rand|9|5|79}}
= 1{{Rand|9|6|82}}
= 8{{Rand|9|7|85}}
= 6