NOM

       drand48,  erand48,  lrand48, nrand48, mrand48, jrand48, srand48, seed48, lcong48 - Générer
       de nombres pseudoaléatoires uniformément distribués

SYNOPSIS

       #include <stdlib.h>

       double drand48(void);

       double erand48(unsigned short xsubi[3]);

       long int lrand48(void);

       long int nrand48(unsigned short xsubi[3]);

       long int mrand48(void);

       long int jrand48(unsigned short xsubi[3]);

       void srand48(long int seedval);

       unsigned short *seed48(unsigned short seed16v[3]);

       void lcong48(unsigned short param[7]);

   Exigences   de   macros   de   test   de   fonctionnalités   pour    la    glibc    (consultez
   feature_test_macros(7)) :

       Pour toutes les fonctions ci-dessus : _SVID_SOURCE || _XOPEN_SOURCE

DESCRIPTION

       Ces  fonctions  génèrent  des  nombres  pseudoaléatoires  en  utilisant  un  algorithme de
       congruence linéaire, et une arithmétique entière sur 48 bits.

       Les fonctions drand48() et erand48() renvoient des valeurs positives en virgule  flottante
       double précision, uniformément distribuées dans l'intervalle [0.0, 1.0].

       Les  fonctions  lrand48()  et nrand48() renvoient des entiers longs positifs, uniformément
       distribués entre 0 et 2^31.

       Les fonctions mrand48() et jrand48() renvoient  des  entiers  longs  signés,  uniformément
       distribués entre -2^31 et 2^31.

       Les  fonctions srand48(), seed48() et lcong48() sont des fonctions d'initialisation. L'une
       d'entre elles doit être appelée avant d'utiliser les  fonctions  drand48(),  lrand48()  ou
       mrand48().  Les fonctions erand48(), nrand48() et jrand48() ne nécessitent pas de fonction
       d'initialisation.

       Toutes ces fonctions engendrent une séquence d'entiers Xi, sur 48 bits, suivant la formule
       de congruence linéaire :

              Xn+1 = (aXn + c) mod m, avec n >= 0

       Le paramètre m vaut 2^48, ainsi l'arithmétique entière sur 48 bits est respectée. Tant que
       lcong48() n'est pas appelé, a et c valent :

              a = 0x5DEECE66D
              c = 0xB

       Les valeurs renvoyées  par  les  fonctions  drand48(),  erand48(),  lrand48(),  nrand48(),
       mrand48()  ou  jrand48()  sont  calculées  en  générant les Xi suivant sur 48 bits dans la
       séquence. Ensuite, le nombre de bits approprié au type de la valeur de retour est copié en
       partant des bits de poids forts de Xi, et convertit dans la valeur renvoyée.

       Les  fonctions drand48(), lrand48() et mrand48() mémorisent le dernier Xi sur 48 bits créé
       dans un tampon interne. Les fonctions erand48(), nrand48() et jrand48() nécessitent que le
       programme  appelant  fournisse  un emplacement de stockage pour les valeurs successives de
       Xi. Cet emplacement est le tableau correspondant à l'argument xsubi.  Ces  fonctions  sont
       initialisées en plaçant la valeur initiale de Xi dans le tableau avant le premier appel.

       La  fonction  d'initialisation  srand48()  définit  les  32 bits  de poids fort de Xi avec
       l'argument seedval.  Les  16 bits  de  poids  faibles  sont  initialisés  avec  la  valeur
       arbitraire 0x330E.

       La  fonction  d'initialisation  seed48() définit la valeur de Xi comme la valeur spécifiée
       dans le tableau seed16v. La précédente valeur de Xi est copiée dans un tampon  interne  et
       un pointeur vers ce tampon est renvoyé par seed48().

       La  fonction  d'initialisation  lcong48()  permet  à  l'utilisateur de définir des valeurs
       initiales de Xi, a et c. Les éléments param[0-2]  du  tableau  spécifient  Xi,  param[3-5]
       spécifient  a  et  param[6]  spécifie  c. Après un appel à lcong48(), un appel ultérieur à
       srand48() ou à seed48() rétablira les valeurs normales de a et c.

ATTRIBUTS

   Multithreading (voir pthreads(7))
       Les fonctions drand48(), erand48(), lrand48(), nrand48(), mrand48(), jrand48(), srand48(),
       seed48()  et  lcong48()  ne  sont  pas  sûres  dans  un  contexte  multithread  car  elles
       enregistrent globalement l'état du générateur de nombre aléatoire.

CONFORMITÉ

       SVr4, POSIX.1-2001.

NOTES

       Ces fonctions sont déclarées obsolètes par SVID 3, qui indique que  rand(3)  devrait  être
       utilisée à la place.

VOIR AUSSI

       rand(3), random(3)

COLOPHON

       Cette  page  fait partie de la publication 3.57 du projet man-pages Linux. Une description
       du projet et des  instructions  pour  signaler  des  anomalies  peuvent  être  trouvées  à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis    2010,    cette   traduction   est   maintenue   à   l'aide   de   l'outil   po4a
       <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du  projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Christophe    Blaess    <http://www.blaess.fr/christophe/>   (1996-2003),   Alain   Portal
       <http://manpagesfr.free.fr/> (2003-2006). Florentin  Duneau  et  l'équipe  francophone  de
       traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>  ou  par  un  rapport  de  bogue   sur   le   paquet
       manpages-fr.

       Vous  pouvez  toujours  avoir  accès  à la version anglaise de ce document en utilisant la
       commande « man -L C <section> <page_de_man> ».

                                           21 juin 2013                                DRAND48(3)