View source for Template:Random number/doc

{{documentation subpage}}
{{template shortcut|Random|Rand}}
This template generates a [[pseudo-random]] integer between 0 and [[Absolute value|{{math|{{abs|''count''}}}}]]-1.

; Usage<nowiki>:</nowiki>
* <code><nowiki>{{</nowiki>Random number<nowiki>|</nowiki></code>''count''<code><nowiki>|</nowiki></code>''seed''<code><nowiki>|</nowiki></code>''prime''<code><nowiki>}}</nowiki></code>
* All parameters are optional and have default values. They must be integers.
* The calculation is {{math|(Prime(Unix + Seed) + (Articles mod Prime)) mod Count}}, where
** the default ''count'' is 100 (so by default, this template generates values between 0 and 99) and must be less than -1 or greater than 1;
** the default ''seed'' is <nowiki>{{#time:z}}</nowiki> (currently {{#time:z}}, i.e. the current day number in the year, at the time this page was last saved or purged from the cache) and can be set to any other integer value (used to generate distinct values on the same page);
** the default ''prime'' is 67 and should be a [[prime number]] above 17 (used to generate distinct values on the same page);
** Unix is the current [[Unix timestamp]] ({{#time:U}}); and
** Articles is the raw number of articles on the English Wikipedia ({{NUMBEROFARTICLES:R}}).

; Examples generating numbers between 0 and 999<nowiki>:</nowiki>
* <code><nowiki>{{Random number}}</nowiki></code> = {{Random number}} (default, gives values between 0 and 99)
* <code><nowiki>{{Random number|1000}}</nowiki></code> = {{Random number|1000}} (second and third digit are the same as above)
* <code><nowiki>{{Random number|1000}}</nowiki></code> = {{Random number|1000}} (same page load, same output)
* <code><nowiki>{{Random number|1000|</nowiki>{{#time:z}}<nowiki>|67}}</nowiki></code> = {{Random number|1000|{{#time:z}}|67}} (same as above)
* <code><nowiki>{{Random number|1000|</nowiki>{{#time:z}}<nowiki>|61}}</nowiki></code> = {{Random number|1000|{{#time:z}}|61}} (this and others should all be different)
* <code><nowiki>{{Random number|1000|6}}</nowiki></code> = {{Random number|1000|6}}
* <code><nowiki>{{Random number|1000|5}}</nowiki></code> = {{Random number|1000|5}}
* <code><nowiki>{{Random number|1000|4}}</nowiki></code> = {{Random number|1000|4}}
* <code><nowiki>{{Random number|1000|3}}</nowiki></code> = {{Random number|1000|3}}
* <code><nowiki>{{Random number|1000|2}}</nowiki></code> = {{Random number|1000|2}}
* <code><nowiki>{{Random number|1000|1}}</nowiki></code> = {{Random number|1000|1}}
* <code><nowiki>{{Random number|1000|0}}</nowiki></code> = {{Random number|1000|0}}
* <code><nowiki>{{Random number|1000|1|17}}</nowiki></code> = {{Random number|1000|0|17}} (varying the prime number)
* <code><nowiki>{{Random number|1000|1|19}}</nowiki></code> = {{Random number|1000|0|19}}
* <code><nowiki>{{Random number|1000|1|23}}</nowiki></code> = {{Random number|1000|0|23}}
* <code><nowiki>{{Random number|1000|1|29}}</nowiki></code> = {{Random number|1000|0|29}}
* <code><nowiki>{{Random number|1000|1|31}}</nowiki></code> = {{Random number|1000|0|31}}
* <code><nowiki>{{Random number|1000|1|37}}</nowiki></code> = {{Random number|1000|0|37}}
* <code><nowiki>{{Random number|1000|1|41}}</nowiki></code> = {{Random number|1000|0|41}}
* <code><nowiki>{{Random number|1000|1|43}}</nowiki></code> = {{Random number|1000|0|43}}
* <code><nowiki>{{Random number|1000|1|47}}</nowiki></code> = {{Random number|1000|0|47}}
* <code><nowiki>{{Random number|1000|1|51}}</nowiki></code> = {{Random number|1000|0|51}}
* <code><nowiki>{{Random number|1000|1|53}}</nowiki></code> = {{Random number|1000|0|53}}
* <code><nowiki>{{Random number|1000|1|59}}</nowiki></code> = {{Random number|1000|0|59}}
* <code><nowiki>{{Random number|1000|1|61}}</nowiki></code> = {{Random number|1000|0|61}}
* <code><nowiki>{{Random number|1000|1|67}}</nowiki></code> = {{Random number|1000|0|67}}
* <code><nowiki>{{Random number|1000|1|71}}</nowiki></code> = {{Random number|1000|0|71}}
* <code><nowiki>{{Random number|1000|1|73}}</nowiki></code> = {{Random number|1000|0|73}}
* <code><nowiki>{{Random number|1000|1|79}}</nowiki></code> = {{Random number|1000|0|79}}

; Note<nowiki>:</nowiki>
* Varying ''seed'' linearly generates numbers that generate a linear sequence on the same page, with equal cyclic steps;
* Varying ''prime'' (provided that they are odd prime numbers) generates pseudo-random that have independent random distribution.
* Note that when ''count'' is even (such as 100 by default, or 1000 in the examples above), the generated numbers (on the same page) are all odd or all even when you are varying the ''seed'' or ''prime'', unless half of the calls use an even ''seed'' and the others used an odd ''seed''. However, later invocations will still alternate odd and even numbers on output (this problem only occurs on the same page where multiple random numbers are invoked).
* On the same page, multiple invocations of this template with the same parameters will generate the same output value, so it is possible to create multiple links related to the same article.

=== See also ===
* {{tl|Random item}}
* {{tl|Random country}}
* {{tl|Random color}}
* {{tl|Random Component}}
* {{tl|Random motto}}
* {{tl|Random page}}
* {{tl|Random page in category}}
* {{tl|Random portal component}}
* {{tl|Random quotation}}
* {{tl|Random slideshow}}
* {{tl|Random subpage}}
* {{tl|Random quote}}
{{cot|[[Special:PrefixIndex/Template:Random]]}}
{{Special:PrefixIndex/Template:Random}}
{{cob}}

<includeonly>{{Sandbox other||
[[Category:Mathematical function templates]]
}}</includeonly>