/usr/share/doc/libbobcat3-dev/man/irandstream.3.html is in libbobcat-dev 3.19.01-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | <html><head>
<title>FBB::IRandStream</title>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1>FBB::IRandStream</h1>
<h2>libbobcat-dev_3.19.01-x.tar.gz</h2>
<h2>2005-2013</h2>
<html><head>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1></h1>
<html><head>
<title>FBB::IRandStream(3bobcat)</title>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1>FBB::IRandStream(3bobcat)</h1>
<h2>libbobcat-dev_3.19.01-x.tar.gz Random numbers istream</h2>
<h2>2005-2013</h2>
<p>
<h2>NAME</h2>FBB::IRandStream - Istream producing random numbers
<p>
<h2>SYNOPSIS</h2>
<strong>#include <bobcat/irandstream></strong><br>
Linking option: <em>-lbobcat</em>
<p>
<h2>DESCRIPTION</h2>
<strong>FBB::IRandStream</strong> objects may be used to extract random numbers in a
given range from a stream.
<p>
<h2>NAMESPACE</h2>
<strong>FBB</strong><br>
All constructors, members, operators and manipulators, mentioned in this
man-page, are defined in the namespace <strong>FBB</strong>.
<p>
<h2>INHERITS FROM</h2>
<strong>std::istream</strong>, <br>
<strong>FBB::RandBuffer</strong> (private)
<p>
<h2>CONSTRUCTORS</h2>
<ul>
<li> <strong>IRandStream(int max)</strong>:<br>
This <strong>FBB::IRandStream()</strong> constructor initializes the random generator.
The default seed (i.e., 1) for the <strong>srand</strong>(3) function is used, meaning that
every new run of the program will generate the same sequence of random
values. Another constructor (see below) is provided when this is not
considered appropriate. Random values between 1 and <em>max</em> (inclusive) are
returned.
<p>
<li> <strong>IRandStream(int min, int max)</strong>:<br>
This <strong>FBB::IRandStream()</strong> constructor initializes the random generator.
The default seed (i.e., 1) for the <strong>srand</strong>(3) function is used, meaning that
every new run of the program will generate the same sequence of random
values. Another constructor (see below) is provided when this is not
considered appropriate. Random values between <em>min</em> and <em>max</em> (inclusive)
are returned.
<p>
<li> <strong>IRandStream(int min, int max, int seed)</strong>:<br>
This <strong>FBB::IRandStream()</strong> constructor initializes the random
generator. The seed is used to initialze the random number generator. To start
the random generator at some unpredictable point, <em>time(0)</em> could be used.
Random values between <em>min</em> and <em>max</em> (inclusive) are returned.
</ul>
<p>
<h2>INHERITED MEMBERS</h2>
<p>
Since the class uses public derivation from <strong>std::istream</strong>, all members
of this class can be used.
<p>
<h2>EXAMPLE</h2>
<pre>
#include <iostream>
#include <bobcat/irandstream>
using namespace std;
using namespace FBB;
int main(int argc, char **argv)
{
IRandStream in(1000);
for (; argc--; )
{
size_t random;
in >> random;
cout << random << endl;
}
return 0;
}
</pre>
<p>
<h2>FILES</h2>
<em>bobcat/irandstream</em> - defines the class interface
<p>
<h2>SEE ALSO</h2>
<strong>bobcat</strong>(7), <strong>randbuffer</strong>(3bobcat)
<p>
<h2>BUGS</h2>
None Reported.
<p>
<h2>DISTRIBUTION FILES</h2>
<ul>
<li> <em>bobcat_3.19.01-x.dsc</em>: detached signature;
<li> <em>bobcat_3.19.01-x.tar.gz</em>: source archive;
<li> <em>bobcat_3.19.01-x_i386.changes</em>: change log;
<li> <em>libbobcat1_3.19.01-x_*.deb</em>: debian package holding the
libraries;
<li> <em>libbobcat1-dev_3.19.01-x_*.deb</em>: debian package holding the
libraries, headers and manual pages;
<li> <em>http://sourceforge.net/projects/bobcat</em>: public archive location;
</ul>
<p>
<h2>BOBCAT</h2>
Bobcat is an acronym of `Brokken's Own Base Classes And Templates'.
<p>
<h2>COPYRIGHT</h2>
This is free software, distributed under the terms of the
GNU General Public License (GPL).
<p>
<h2>AUTHOR</h2>
Frank B. Brokken (<strong>f.b.brokken@rug.nl</strong>).
<p>
|