VLRCW_R 3CW "20 March 2008" "mathcw-1.00"

Table of contents


NAME

vlrcwf_r, vlrcw_r, vlrcwl_r, vlrcww_r, vlrcwq_r, vlrcwll_r, vlrcwdf_r, vlrcwd_r, vlrcwdl_r, vlrcwdll_r - vector of logarithmically-distributed random numbers with external state

SYNOPSIS

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

#include <mathcw.h>

extern float vlrcwf_r (randcw_state_t state, int n, float u[], float a, float b);

extern double vlrcw_r (randcw_state_t state, int n, double u[], double a, double b);

extern long double vlrcwl_r (randcw_state_t state, int n, long double u[], long double a, long double b);

extern __float80 vlrcww_r (randcw_state_t state, int n, __float80 u[], __float80 a, __float80 b);

extern __float128 vlrcwq_r (randcw_state_t state, int n, __float128 u[], __float128 a, __float128 b);

extern long_long_double vlrcwll_r (randcw_state_t state, int n, long_long_double u[],
                                   long_long_double a, long_long_double b);

extern decimal_float vlrcwdf_r (randcw_state_t state, int n, decimal_float u[],
                                decimal_float a, decimal_float b);

extern decimal_double vlrcwd_r (randcw_state_t state, int n, decimal_double u[],
                                decimal_double a, decimal_double b);

extern decimal_long_double vlrcwdl_r (randcw_state_t state, int n, decimal_long_double u[],
                                      decimal_long_double a, decimal_long_double b);

extern decimal_long_long_double vlrcwdll_r (randcw_state_t state, int n, decimal_long_long_double u[],
                                            decimal_long_long_double a, decimal_long_long_double b);

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


DESCRIPTION

Compute a vector of random numbers logarithmically distributed in the range [a,b], which must not contain zero.

The generator state is keep externally in the state argument, a vector of four UINT_LEAST32_T values, most conveniently initialized with incw_r(). This makes the functions thread safe, and allows creation of a practically-unlimited number of independent families of generators, each with its own state.


RETURN VALUES

Return the vector of random numbers.

ERRORS

If either endpoint argument is a NaN, return that NaN. If the argument range contains zero, return a NaN. If either argument is Infinity, return that Infinity.

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(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), 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).