File: Reading-and-writing-random-number-generator-state.html

package info (click to toggle)
gsl-ref-html 2.3-1
  • links: PTS
  • area: non-free
  • in suites: bullseye, buster, sid
  • size: 6,876 kB
  • ctags: 4,574
  • sloc: makefile: 35
file content (101 lines) | stat: -rw-r--r-- 5,382 bytes parent folder | download
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
<!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 &ndash; Reference Manual: Reading and writing random number generator state</title>

<meta name="description" content="GNU Scientific Library &ndash; Reference Manual: Reading and writing random number generator state">
<meta name="keywords" content="GNU Scientific Library &ndash; Reference Manual: Reading and writing random number generator state">
<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-generator-algorithms.html#Random-number-generator-algorithms" rel="next" title="Random number generator algorithms">
<link href="Copying-random-number-generator-state.html#Copying-random-number-generator-state" rel="previous" title="Copying random number generator state">
<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="Reading-and-writing-random-number-generator-state"></a>
<div class="header">
<p>
Next: <a href="Random-number-generator-algorithms.html#Random-number-generator-algorithms" accesskey="n" rel="next">Random number generator algorithms</a>, Previous: <a href="Copying-random-number-generator-state.html#Copying-random-number-generator-state" accesskey="p" rel="previous">Copying random number generator state</a>, Up: <a href="Random-Number-Generation.html#Random-Number-Generation" accesskey="u" rel="up">Random Number Generation</a> &nbsp; [<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Reading-and-writing-random-number-generator-state-1"></a>
<h3 class="section">18.8 Reading and writing random number generator state</h3>

<p>The library provides functions for reading and writing the random
number state to a file as binary data.
</p>
<dl>
<dt><a name="index-gsl_005frng_005ffwrite"></a>Function: <em>int</em> <strong>gsl_rng_fwrite</strong> <em>(FILE * <var>stream</var>, const gsl_rng * <var>r</var>)</em></dt>
<dd><p>This function writes the random number state of the random number
generator <var>r</var> to the stream <var>stream</var> in binary format.  The
return value is 0 for success and <code>GSL_EFAILED</code> if there was a
problem writing to the file.  Since the data is written in the native
binary format it may not be portable between different architectures.
</p></dd></dl>

<dl>
<dt><a name="index-gsl_005frng_005ffread"></a>Function: <em>int</em> <strong>gsl_rng_fread</strong> <em>(FILE * <var>stream</var>, gsl_rng * <var>r</var>)</em></dt>
<dd><p>This function reads the random number state into the random number
generator <var>r</var> from the open stream <var>stream</var> in binary format.
The random number generator <var>r</var> must be preinitialized with the
correct random number generator type since type information is not
saved.  The return value is 0 for success and <code>GSL_EFAILED</code> if
there was a problem reading from the file.  The data is assumed to
have been written in the native binary format on the same
architecture.
</p></dd></dl>




</body>
</html>