Manuel des Scripts Automation Engine > Organisation fonctionnelle > Arithmetics > RANDOM

RANDOM

Fonction de script : Génère des nombres aléatoires.

Syntaxe

RANDOM(Minimum, Maximum, [Basis])

Syntaxe	Description / format
Minimum	Valeur minimale du nombre aléatoire généré. Format : Nombre ou variable de script
Maximum	Valeur maximale du nombre aléatoire généré. Format : Nombre ou variable de script
Base	Valeur initiale pour la génération. Format : Nombre ou variable de script

Code retour
Nombre aléatoire dans l'intervalle indiqué.

Remarques

La fonction de script RANDOM génère des nombres aléatoires. Un générateur de nombres produit une série de nombres déterminée par la valeur initiale (la base).

Si la base n'est pas spécifiée, cette fonction de script retourne un nombre qui varie sans cesse entre le minimum et le maximum.

Si la base est spécifiée, le générateur de nombres aléatoires est initialisé avec cette valeur. Le résultat est une série numérique dont le nombre peut être lu sans que la base soit nécessaire. La série de nombres générée est toujours la même pour une valeur initiale définie : les mêmes nombres sont fournis dans le même ordre.

Si la fonction de script est exécutée simultanément dans le script d'un autre objet, elle remplace la série de nombres déjà générée.

La fonction de script permet uniquement de transférer des nombres entiers positifs (type de données : unsigned) ! Le résultat est toujours un nombre entier positif.

Exemples

Dans le premier exemple, la fonction fournit un nombre entre 1 et 10 (les deux nombres sont inclus). Le résultat est "3" par exemple.
:SET &nombre# = RANDOM(1, 10)
Le deuxième exemple génère une série de nombres en utilisant le paramètre Base. Il est possible d'accéder à ces valeurs en exécutant la fonction à nouveau. Les 10 premières valeurs de la série de nombres générée avec la base "1" sont : 6, 2, 9, 6, 5, 4, 9, 9, 8 et 2. Ainsi, le resultat du premier appel stocké dans "&nombre#" est toujours "6".
:SET &ret# = RANDOM(&min#, &max#, 1)
:SET &number# = RANDOM(&min#, &max#)

Notez que les séries numériques générées en utilisant Base "1" sont des exemples. Selon la plateforme sur laquelle RANDOM est exécutée, les séries peuvent être différentes.

Rubriques connexes :

Elément de script	Description
ADD	Exécute une addition.
SUB	Exécute une soustraction.
MULT	Exécute une multiplication.
MOD	Retourne le reste d'une division.
DIV	Retourne le reste d'une division.

Eléments de script - Calculs

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle