NRCW 3CW "08 March 2008" "mathcw-1.00"

Table of contents


NAME

nrcwf, nrcw, nrcwl, nrcww, nrcwq, nrcwll, nrcwdf, nrcwd, nrcwdl, nrcwdll - normally-distributed random numbers

SYNOPSIS

cc [ flags ] -I/usr/local/include file(s) -L/usr/local/lib -lmcw [ ... ]

#include <mathcw.h>

extern float nrcwf (void);

extern double nrcw (void);

extern long double nrcwl (void);

extern __float80 nrcww (void);

extern __float128 nrcwq (void);

extern long_long_double nrcwll (void);

extern decimal_float nrcwdf (void);

extern decimal_double nrcwd (void);

extern decimal_long_double nrcwdl (void);

extern decimal_long_long_double nrcwdll (void);

NB: Functions with prototypes containing underscores in type names may be available only with certain extended compilers.


DESCRIPTION

Compute a normally-distributed random number corresponding to a normal distribution with zero mean and unit standard deviation and variance.

The generator state is kept internally to simplify the user interface. However, this is not safe in multithreaded programs. For them, use the reentrant generator routines instead, identified by the suffix _r. The reentrant routines also make possible families of independent generators within the same program.

The computed value can later be transformed to an arbitrary normal distribution with mean M and standard deviation S with the expression M + S * nrcw().


RETURN VALUES

Return the random number.

ERRORS

None.

SEE ALSO

ercw(3CW), ercw_r(3CW), gscw(3CW), incw_r(3CW), llrancw(3CW), llrancw_r(3CW), llrincw(3CW), llrincw_r(3CW), lrancw(3CW), lrancw_r(3CW), lrcw(3CW), lrcw_r(3CW), lrincw(3CW), lrincw_r(3CW), mscw(3CW), nrcw_r(3CW), sccw(3CW), sscw(3CW), urcw(3CW), urcw1(3CW), urcw1_r(3CW), urcw2(3CW), urcw2_r(3CW), urcw3(3CW), urcw3_r(3CW), urcw4(3CW), urcw4_r(3CW), urcw_r(3CW), vercw(3CW), vercw_r(3CW), vllrancw(3CW), vllrancw_r(3CW), vllrincw(3CW), vllrincw_r(3CW), vlrancw(3CW), vlrancw_r(3CW), vlrcw(3CW), vlrcw_r(3CW), vlrincw(3CW), vlrincw_r(3CW), vnrcw(3CW), vnrcw_r(3CW), vurcw(3CW), vurcw1(3CW), vurcw1_r(3CW), vurcw2(3CW), vurcw2_r(3CW), vurcw3(3CW), vurcw3_r(3CW), vurcw4(3CW), vurcw4_r(3CW), vurcw_r(3CW).