NOM

       random, srandom, initstate, setstate - Générateur de nombres aléatoires

SYNOPSIS

       #include <stdlib.h>

       long int random(void);

       void srandom(unsigned int seed);

       char *initstate(unsigned int seed, char *state, size_t n);
       char *setstate(char *state);

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

       random(), srandom(), initstate(), setstate() :
           _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE >= 500 ||
           _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED

DESCRIPTION

       La  fonction random() utilise un générateur de nombre aléatoire non linéaire (« non-linear
       additive feedback random number generator ») utilisant une table par défaut de 31  entiers
       longs  pour  renvoyer  successivement des nombres pseudoaléatoires entre 0 et RAND_MAX. La
       période de ce générateur est très grande, approximativement 16 * ((2^31) - 1).

       La fonction srandom() utilise son argument comme « graine » pour  engendrer  une  nouvelle
       séquence  de  nombre  pseudoaléatoires  qui seront fournis lors des appels à random(). Ces
       séquences sont reproductibles en invoquant srandom() avec la même graine. Si aucune graine
       n'est fournie, La fonction random() utilise automatiquement une graine originale de valeur
       1.

       La fonction initstate() permet d'initialiser une table d'états state pour l'utiliser  avec
       random().  La  taille n de la table est utilisée par initstate() pour déterminer le niveau
       de sophistication du générateur de nombre aléatoires. Plus grande  est  la  table  d'état,
       meilleurs   seront   les   nombres   aléatoires.   seed   est   la  graine  utilisée  pour
       l'initialisation, indiquant un point de départ pour la séquence de nombres, et  permet  de
       redémarrer au même endroit.

       La  fonction  setstate()  modifie  la  table d'états utilisée par la fonction random(). La
       table d'état state est alors utilisée comme  générateur  de  nombres  aléatoires  jusqu'au
       prochain  appel  de  initstate()  ou  setstate(). state doit d'abord être initialisée avec
       initstate() ou être le résultat d'un appel précédent à setstate()

VALEUR RENVOYÉE

       La fonction random() renvoie une valeur entre 0 et  RAND_MAX.  La  fonction  srandom()  ne
       renvoie pas de valeur.

       La  fonction  initstate()  renvoie  un  pointeur  sur  la table d'états précédente. En cas
       d'échec, errno contient le code d'erreur.

       La fonction setstate() renvoie un  pointeur  sur  la  table  d'états  précédente.  En  cas
       d'échec, NULL est renvoyé et errno contient le code d'erreur.

ERREURS

       EINVAL Le paramètre state de setstate() était NULL.

       EINVAL Une table d'états de moins de 8 octets a été fournie à initstate().

ATTRIBUTS

   Multithreading (voir pthreads(7))
       Les  fonctions  random(),  srandom(), initstate() et setstate() sont sûre dans un contexte
       multithread.

CONFORMITÉ

       BSD 4.3, POSIX.1-2001.

NOTES

       Actuellement, les valeurs optimales n, pour la taille de la table d'états sont 8, 32,  64,
       128,  et  256 octets.  Les  autres  valeurs  seront  arrondies à la taille la plus proche.
       Essayer d'utiliser moins de 8 octets déclenche une erreur.

       Cette fonction ne devrait pas être utilisée si plusieurs threads utilisent random() et  si
       le comportement doit être reproductible. Utilisez random_r(3) dans ce cas.

       La génération de nombres aléatoires est un sujet complexe. Numerical Recipes in C: The Art
       of Scientific Computing (William H. Press, Brian P. Flannery, Saul A.  Teukolsky,  William
       T. Vetterling; New York: Cambridge University Press, 2007, 3rd ed.) fournit une excellente
       discussion sur les problèmes pratiques de génération de noms aléatoires dans le chapitre 7
       (Random Numbers).

       Pour  une discussion plus théorique, qui aborde également en profondeur d'autres domaines,
       voir le chapitre 3 (Random Numbers) du livre de  Donald  E.  Knuth  The  Art  of  Computer
       Programming,  volume  2  (Seminumerical  Algorithms),  2nd  ed.;  Reading,  Massachusetts:
       Addison-Wesley Publishing Company, 1981.

BOGUES

       D'après POSIX, initstate() devrait renvoyer NULL en cas d'erreur. Dans la mise en œuvre de
       la  glibc, errno est renseigné en cas d'erreur comme spécifié, mais la fonction ne renvoie
       pas NULL

VOIR AUSSI

       drand48(3), rand(3), random_r(3), srand(3)

COLOPHON

       Cette page fait partie de la publication 3.65 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).  Nicolas  François  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> ».