$math.random

Alias: $math.rnd

Description

Retourne une valeur aléatoire en double entre 0 et 1.

Syntaxe

$math.random( [ options ] )

Paramètres

options map

Options de calcul de la valeur random. Les options reconnues sont:

type string

Type de valeur à générer. Les types reconnus sont "int" (ou "integer"), "long", "double" (ou "decimal"), "boolean", "string", "gaussian". La valeur par défaut est "double".

seed number

Valeur racine pour la génération de la valeur random. La valeur attendue doit être un nombre compris entre -2⁶³ et 2⁶³-1.

min number

Limite inférieure de la plage de valeurs possibles. Sans effet pour les types "boolean", gaussian" et "string".

La valeur par défaut correspond à la plus petite valeur possible pour le type indiqué. Si l'option max est spécifiée, alors la valeur par défaut de min est 0.

max number

Limite supérieure de la plage de valeurs possibles (non incluse). Sans effet pour les types "boolean", gaussian" et "string".

Si max est défini sans min, la méthode force un min à 0.

length number

Longueur de la chaîne à construire (uniquement valable lorsque type est défini à "string".

alphabet string

Alphabet autorisé pour la génération de câines de caractères (type string). Si non défini, la méthode s'appuie sur un alphabet de 62 caractères comprenant les lettres minuscules, les lettres majuscules et les chiffres.

Retour

Valeur aléatoire prise entre les bornes indiquée. En l'absence d'options, la méthode retourne une valeur aléatoire comprise entre 0 et 1 non compris.

Retourne null en cas d'erreur.

Exemple

$math.random();                                           // 0.6302102257193494

$math.random( { type: "gaussian"} );                      // -1.9952274222651456

$math.random( { type: "boolean" } );                      // 0

$math.random( { type: "int" } );                          // -1815405358
$math.random( { type: "int", min: 0 } );                  // 812478457
$math.random( { type: "int", max: 10000 } );              // 1905
$math.random( { type: "int", min: 10, max: 20 } );        // 11
$math.random( { type: "int", min: -20, max: -10 } );      // -13

$math.random( { type: "long" } );                         // 8905176739385258068
$math.random( { type: "long", min: 0 } );                 // 445361369305759989
$math.random( { type: "long", max: 10000 } );             // 2431
$math.random( { type: "long", min: 10, max: 20 } );       // 12
$math.random( { type: "long", min: -20, max: -10 } );     // -18

$math.random( { type: "double" } );                       // 0.7816274713140284
$math.random( { type: "double", min: 0 } );               // 3.364167396432945E307
$math.random( { type: "double", max: 10000 } );           // 6704.909306936824
$math.random( { type: "double", min: 10, max: 20 } );     // 12.035434770170571
$math.random( { type: "double", min: -20, max: -10 } );   // -14.080809724349376

$math.random( { type: "string" } );                       // k
$math.random( { type: "string", length: 10 } );           // WfEv4fCPoJ
$math.random( { type: "string", length: 10,
                alphabet: "aeiouàâîïôöûùüéèêë" } );       // ôùuêàîöîiö