1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 The GSL Team.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being "GNU General Public License" and "Free Software
Needs Free Documentation", the Front-Cover text being "A GNU Manual",
and with the Back-Cover Text being (a) (see below). A copy of the
license is included in the section entitled "GNU Free Documentation
License".
(a) The Back-Cover Text is: "You have the freedom to copy and modify this
GNU Manual." -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Scientific Library – Reference Manual: Auxiliary random number generator functions</title>
<meta name="description" content="GNU Scientific Library – Reference Manual: Auxiliary random number generator functions">
<meta name="keywords" content="GNU Scientific Library – Reference Manual: Auxiliary random number generator functions">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Function-Index.html#Function-Index" rel="index" title="Function Index">
<link href="Random-Number-Generation.html#Random-Number-Generation" rel="up" title="Random Number Generation">
<link href="Random-number-environment-variables.html#Random-number-environment-variables" rel="next" title="Random number environment variables">
<link href="Sampling-from-a-random-number-generator.html#Sampling-from-a-random-number-generator" rel="previous" title="Sampling from a random number generator">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Auxiliary-random-number-generator-functions"></a>
<div class="header">
<p>
Next: <a href="Random-number-environment-variables.html#Random-number-environment-variables" accesskey="n" rel="next">Random number environment variables</a>, Previous: <a href="Sampling-from-a-random-number-generator.html#Sampling-from-a-random-number-generator" accesskey="p" rel="previous">Sampling from a random number generator</a>, Up: <a href="Random-Number-Generation.html#Random-Number-Generation" accesskey="u" rel="up">Random Number Generation</a> [<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Auxiliary-random-number-generator-functions-1"></a>
<h3 class="section">18.5 Auxiliary random number generator functions</h3>
<p>The following functions provide information about an existing
generator. You should use them in preference to hard-coding the generator
parameters into your own code.
</p>
<dl>
<dt><a name="index-gsl_005frng_005fname"></a>Function: <em>const char *</em> <strong>gsl_rng_name</strong> <em>(const gsl_rng * <var>r</var>)</em></dt>
<dd><p>This function returns a pointer to the name of the generator.
For example,
</p>
<div class="example">
<pre class="example">printf ("r is a '%s' generator\n",
gsl_rng_name (r));
</pre></div>
<p>would print something like <code>r is a 'taus' generator</code>.
</p></dd></dl>
<dl>
<dt><a name="index-gsl_005frng_005fmax"></a>Function: <em>unsigned long int</em> <strong>gsl_rng_max</strong> <em>(const gsl_rng * <var>r</var>)</em></dt>
<dd><p><code>gsl_rng_max</code> returns the largest value that <code>gsl_rng_get</code>
can return.
</p></dd></dl>
<dl>
<dt><a name="index-gsl_005frng_005fmin"></a>Function: <em>unsigned long int</em> <strong>gsl_rng_min</strong> <em>(const gsl_rng * <var>r</var>)</em></dt>
<dd><p><code>gsl_rng_min</code> returns the smallest value that <code>gsl_rng_get</code>
can return. Usually this value is zero. There are some generators with
algorithms that cannot return zero, and for these generators the minimum
value is 1.
</p></dd></dl>
<dl>
<dt><a name="index-gsl_005frng_005fstate"></a>Function: <em>void *</em> <strong>gsl_rng_state</strong> <em>(const gsl_rng * <var>r</var>)</em></dt>
<dt><a name="index-gsl_005frng_005fsize"></a>Function: <em>size_t</em> <strong>gsl_rng_size</strong> <em>(const gsl_rng * <var>r</var>)</em></dt>
<dd><p>These functions return a pointer to the state of generator <var>r</var> and
its size. You can use this information to access the state directly. For
example, the following code will write the state of a generator to a
stream,
</p>
<div class="example">
<pre class="example">void * state = gsl_rng_state (r);
size_t n = gsl_rng_size (r);
fwrite (state, n, 1, stream);
</pre></div>
</dd></dl>
<dl>
<dt><a name="index-gsl_005frng_005ftypes_005fsetup"></a>Function: <em>const gsl_rng_type **</em> <strong>gsl_rng_types_setup</strong> <em>(void)</em></dt>
<dd><p>This function returns a pointer to an array of all the available
generator types, terminated by a null pointer. The function should be
called once at the start of the program, if needed. The following code
fragment shows how to iterate over the array of generator types to print
the names of the available algorithms,
</p>
<div class="example">
<pre class="example">const gsl_rng_type **t, **t0;
t0 = gsl_rng_types_setup ();
printf ("Available generators:\n");
for (t = t0; *t != 0; t++)
{
printf ("%s\n", (*t)->name);
}
</pre></div>
</dd></dl>
<hr>
<div class="header">
<p>
Next: <a href="Random-number-environment-variables.html#Random-number-environment-variables" accesskey="n" rel="next">Random number environment variables</a>, Previous: <a href="Sampling-from-a-random-number-generator.html#Sampling-from-a-random-number-generator" accesskey="p" rel="previous">Sampling from a random number generator</a>, Up: <a href="Random-Number-Generation.html#Random-Number-Generation" accesskey="u" rel="up">Random Number Generation</a> [<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|
