5 /* Copyright (C) 1999 Free Software Foundation, Inc.
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2, or (at your option)
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this software; see the file COPYING. If not, write to
19 * the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
20 * Boston, MA 02111-1307 USA
22 * As a special exception, the Free Software Foundation gives permission
23 * for additional uses of the text contained in its release of GUILE.
25 * The exception is that, if you link the GUILE library with other files
26 * to produce an executable, this does not by itself cause the
27 * resulting executable to be covered by the GNU General Public License.
28 * Your use of that executable is in no way restricted on account of
29 * linking the GUILE library code into it.
31 * This exception does not however invalidate any other reasons why
32 * the executable file might be covered by the GNU General Public License.
34 * This exception applies only to the code released by the
35 * Free Software Foundation under the name GUILE. If you copy
36 * code from other Free Software Foundation releases into a copy of
37 * GUILE, as the General Public License permits, the exception does
38 * not apply to the code that you add in this way. To avoid misleading
39 * anyone as to the status of such modified files, you must delete
40 * this exception notice from them.
42 * If you write modifications of your own for GUILE, it is your choice
43 * whether to permit this exception to apply to your modifications.
44 * If you do not wish that, delete this exception notice. */
46 /* Software engineering face-lift by Greg J. Badros, 11-Dec-1999,
47 gjb@cs.washington.edu, http://www.cs.washington.edu/homes/gjb */
50 #include "libguile/__scm.h"
54 * A plugin interface for RNGs
56 * Using this interface, it is possible for the application to tell
57 * libguile to use a different RNG. This is desirable if it is
58 * necessary to use the same RNG everywhere in the application in
59 * order to prevent interference, if the application uses RNG
60 * hardware, or if the application has special demands on the RNG.
62 * Look how the default generator is "plugged in" in scm_init_random().
65 typedef struct scm_rstate
{
68 /* Custom fields follow here */
71 typedef struct scm_rng
{
72 size_t rstate_size
; /* size of random state */
73 unsigned long (*random_bits
) (scm_rstate
*state
); /* gives 32 random bits */
74 void (*init_rstate
) (scm_rstate
*state
, char *seed
, int n
);
75 scm_rstate
*(*copy_rstate
) (scm_rstate
*state
);
78 extern scm_rng scm_the_rng
;
84 typedef struct scm_i_rstate
{
90 extern unsigned long scm_i_uniform32 (scm_i_rstate
*);
91 extern void scm_i_init_rstate (scm_i_rstate
*, char *seed
, int n
);
92 extern scm_i_rstate
*scm_i_copy_rstate (scm_i_rstate
*);
96 * Random number library functions
98 extern scm_rstate
*scm_c_make_rstate (char *, int);
99 extern scm_rstate
*scm_c_default_rstate (void);
100 #define scm_c_uniform32(RSTATE) scm_the_rng.random_bits (RSTATE)
101 extern double scm_c_uniform01 (scm_rstate
*);
102 extern double scm_c_normal01 (scm_rstate
*);
103 extern double scm_c_exp1 (scm_rstate
*);
104 extern unsigned long scm_c_random (scm_rstate
*, unsigned long m
);
105 extern SCM
scm_c_random_bignum (scm_rstate
*, SCM m
);
109 * Scheme level interface
111 extern long scm_tc16_rstate
;
112 #define SCM_RSTATE(obj) ((scm_rstate *) SCM_CDR (obj))
113 #define SCM_RSTATEP(obj) (SCM_NIMP(obj) && (SCM_TYP16 (obj) == scm_tc16_rstate))
115 extern unsigned char scm_masktab
[256];
117 extern SCM scm_var_random_state
;
118 extern SCM
scm_random (SCM n
, SCM state
);
119 extern SCM
scm_copy_random_state (SCM state
);
120 extern SCM
scm_seed_to_random_state (SCM seed
);
121 extern SCM
scm_random_uniform (SCM state
);
122 extern SCM
scm_random_solid_sphere_x (SCM v
, SCM state
);
123 extern SCM
scm_random_hollow_sphere_x (SCM v
, SCM state
);
124 extern SCM
scm_random_normal (SCM state
);
125 extern SCM
scm_random_normal_vector_x (SCM v
, SCM state
);
126 extern SCM
scm_random_exp (SCM state
);
127 extern void scm_init_random (void);