IPB
>  Man Pages > Linux > Suse Linux 10.1 > Section 3 > random man page

random man page

Section 3 - Suse Linux 10.1 Man Pages

Other operating system man pages available here


Advanced Search

Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!


RANDOM(3)                  Linux Programmer's Manual                 RANDOM(3)




NAME

       random, srandom, initstate, setstate - random number generator


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);


DESCRIPTION

       The random() function uses a non-linear additive feedback random number
       generator employing a default table of size 31 long integers to  return
       successive  pseudo-random numbers in the range from 0 to RAND_MAX.  The
       period of this random number generator  is  very  large,  approximately
       16*((2**31)-1).

       The srandom() function sets its argument as the seed for a new sequence
       of pseudo-random integers to be returned by random().  These  sequences
       are  repeatable  by  calling srandom() with the same seed value.  If no
       seed value is provided, the random() function is  automatically  seeded
       with a value of 1.

       The  initstate()  function allows a state array state to be initialized
       for use by random().  The size of the state array n is  used  by  init
       state() to decide how sophisticated a random number generator it should
       use — the larger the state array, the better the  random  numbers  will
       be.   seed is the seed for the initialization, which specifies a start-
       ing point for the random number sequence, and provides  for  restarting
       at the same point.

       The  setstate()  function  changes the state array used by the random()
       function.  The state array state is used for random  number  generation
       until  the  next  call  to initstate() or setstate().  state must first
       have been initialized using initstate() or be the result of a  previous
       call of setstate().


RETURN VALUE

       The  random()  function  returns  a  value between 0 and RAND_MAX.  The
       srandom() function returns no value.  The  initstate()  and  setstate()
       functions  return  a  pointer  to  the previous state array, or NULL on
       error.


ERRORS

       EINVAL A state array of less than 8 bytes was specified to initstate().


NOTES

       Current  "optimal"  values for the size of the state array n are 8, 32,
       64, 128, and 256 bytes; other amounts will be rounded down to the near-
       est known amount.  Using less than 8 bytes will cause an error.


CONFORMING TO

       4.3BSD


SEE ALSO

       rand(3), srand(3)



GNU                               2000-08-20                         RANDOM(3)


Man(1) output converted with man2html and wrapped by fishsponge

This page was generated on Tue Feb 13 02:18:59 GMT 2007

Your favourite pages:

No pages logged yet.
Trying to save cookie...

Top 10 most popular pages:

CPAN man page (4333 hits)
(Suse Linux 10.1)

ssh man page (4186 hits)
(Suse Linux 10.1)

adv_cap_autoneg man page (4167 hits)
(Solaris 10 11_06)

sqlite3 man page (4090 hits)
(openSUSE 10.2)

svn man page (3251 hits)
(FreeBSD 6.2)

startproc man page (1908 hits)
(Suse Linux 10.1)

pprosetup man page (1667 hits)
(Solaris 10 11_06)

netcat man page (1614 hits)
(Suse Linux 10.1)

signal man page (1595 hits)
(Suse Linux 10.1)

ssh-socks5-proxy-connect man page (1563 hits)
(Solaris 10 11_06)

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Partners: Cambridge Plus :: Pyrenees Summer Activities :: Illuminated Touch Panel :: <Link Available>
Unix Man Pages / Linux Man Pages :: HiFi Forum :: SIP VoIP Phone & Provider Reviews :: UNIX/Linux Forum Archives

More info on advertising on Unix/Linux Forum