Aller au contenu

Modèle:Rand/Documentation

De Wikivoyage
Ceci est la page de documentation du modèle {{Rand}}.
Cette sous-page contient les instructions, les catégories et les liens interlangues de son modèle d’origine et elle n’est pas destinée à être visualisée directement.
Utilisation :
Ce modèle permet de générer un entier pseudo-aléatoire dans un intervalle spécifié. Il est possible de générer des suites pseudo-aléatoires indépendantes.
Syntaxe :
{{Rand|1=min|2=max|3=graine|4=nombre premier}}
  • Tous les paramètres sont optionnels et ont des valeurs par défaut. Ils doivent tous être des entiers.
  • Les valeurs min et max sont de signe quelconque, par défaut ce sont 0 et 99.
  • La graine par défaut est 7, ce peut être n’importe quelle autre valeur (utilisée pour générer des valeurs distinctes sur la même page).
  • Le nombre premier par défaut est 67 et devrait être un nombre pas trop grand, supérieur ou égal à 17 (utilisé pour générer des valeurs distinctes sur la même page).
Exemples générant des nombres entre 0 et 999 :
  • {{Rand|0|999}} = 219
  • {{Rand|0|999|7|67}} = 219 (résultat identique)
  • {{Rand|0|999|7|61}} = 676 (celui-ci et les suivants devraient tous être différents)
  • {{Rand|0|999|6}} = 168
  • {{Rand|0|999|5}} = 117
  • {{Rand|0|999|4}} = 66
  • {{Rand|0|999|3}} = 15
  • {{Rand|0|999|2}} = 964
  • {{Rand|0|999|1}} = 913
  • {{Rand|0|999|0|61}} = 682
  • {{Rand|0|999|0|67}} = 862
  • {{Rand|0|999|0|71}} = 664
  • {{Rand|0|999|0|73}} = 251
  • {{Rand|0|999|0|79}} = 540
Note :
  • Une variation linéaire de la graine génère au sein de la même page des nombres distribués linéairement et séparés d’un pas constant ne dépendant que du choix du nombre premier; les suites pseudo-aléatoires obtenues en faisant varier la graine sont liées uniquement par le rang du premier nombre commun de la suite, toutes les suites alors ayant le même cycle.
  • Une variation du nombre premier (pourvu que ce soit bien un nombre premier) génère sur la même page utilisant ce modèle plusieurs fois des suites pseudo-aléatoires qui ont des distributions pseudo-aléatoires indépendantes.
  • Ne pas abuser de ce modèle, les pages étant alors difficilement reproductibles. Ce modèle ne devrait être utilisé que pour sélectionner des modèles dans une liste stable et connue (par exemple une image prise dans une galerie qu'on peut parcourir de façon non aléatoire).