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}}= 100{{Rand|1000|6}}= 99{{Rand|1000|5}}= 98{{Rand|1000|4}}= 97{{Rand|1000|3}}= 96{{Rand|1000|2}}= 95{{Rand|1000|1}}= 94{{Rand|1000|0}}= 93
variando o valor de prime
{{Rand|1000|1|17}}= 144{{Rand|1000|1|19}}= 102{{Rand|1000|1|23}}= 18{{Rand|1000|1|29}}= 892{{Rand|1000|1|31}}= 850{{Rand|1000|1|37}}= 724{{Rand|1000|1|41}}= 640{{Rand|1000|1|43}}= 598{{Rand|1000|1|47}}= 514{{Rand|1000|1|51}}= 430{{Rand|1000|1|53}}= 388{{Rand|1000|1|59}}= 262{{Rand|1000|1|61}}= 220{{Rand|1000|1|67}}= 94{{Rand|1000|1|71}}= 10{{Rand|1000|1|73}}= 968{{Rand|1000|1|79}}= 842
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}}= 94{{Rand|100|2|67}}= 95{{Rand|100|3|67}}= 96{{Rand|100|4|67}}= 97{{Rand|100|5|67}}= 98
sequências com mesma paridade:
{{Rand|10|1|1}}= 0{{Rand|10|1|3}}= 8{{Rand|10|1|5}}= 6{{Rand|10|1|7}}= 4{{Rand|10|1|9}}= 2{{Rand|10|1|11}}= 0{{Rand|10|1|13}}= 8
a partir do segundo ou terceiro, os valores se repetem:
{{Rand|9|1|67}}= 8{{Rand|9|1|70}}= 2{{Rand|9|1|73}}= 5{{Rand|9|1|76}}= 8{{Rand|9|1|79}}= 2{{Rand|9|1|82}}= 5{{Rand|9|1|85}}= 8
problema não é resolvido variando-se seed:
{{Rand|9|1|67}}= 8{{Rand|9|2|70}}= 3{{Rand|9|3|73}}= 7{{Rand|9|4|76}}= 2{{Rand|9|5|79}}= 6{{Rand|9|6|82}}= 1{{Rand|9|7|85}}= 5