/usr/share/doc/libbobcat2-dev/man/randbuffer.3.html is in libbobcat-dev 2.20.01-1.
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 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 | <html><head>
<title>FBB::RandBuffer</title>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1>FBB::RandBuffer</h1>
<h2>libbobcat1-dev_2.20.01-x.tar.gz</h2>
<h2>2005-2011</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::RandBuffer(3bobcat)</title>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1>FBB::RandBuffer(3bobcat)</h1>
<h2>libbobcat1-dev_2.20.01-x.tar.gz random number streambuf</h2>
<h2>2005-2011</h2>
<p>
<h2>NAME</h2>FBB::RandBuffer - std::streambuf generating random numbers
<p>
<h2>SYNOPSIS</h2>
<strong>#include <bobcat/randbuffer></strong><br>
Linking option: <em>-lbobcat</em>
<p>
<h2>DESCRIPTION</h2>
<p>
<strong>FBB:RandBuffer</strong> objects may be used as a <strong>std::streambuf</strong> of
<em>std::istream</em> objects to allow the extraction of random numbers from the
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>
std::streambuf
<p>
<h2>CONSTRUCTOR</h2>
<ul>
<li> <strong>Randbuffer(int min, int max, size_t seed = 1)</strong>:<br>
This <strong>Randbuffer()</strong> constructor initializes the random generator. The
seed is used to initialze the random number generator.Random values between
<em>min</em> and <em>max</em> (inclusive) are returned.
</ul>
<p>
<h2>VIRTUAL MEMBERS</h2>
<p>
<ul>
<li> <strong>int underflow()</strong>:<br>
This function is called by <em>std::istream</em> objects using
<strong>Randbuffer</strong>. It produces the next available random number, separating the
random numbers by one blanks space. Random values between <em>min</em> and <em>max</em>
(inclusive) are returned (see the description of the constructor).
</ul>
<p>
<h2>INHERITED MEMBERS</h2>
<p>
Since the class uses public derivation from
<strong>std::streambuf</strong>, all members of this class can be used.
<p>
<h2>EXAMPLE</h2>
<pre>
#include <iostream>
#include <istream>
#include <bobcat/randbuffer>
#include <bobcat/a2x>
using namespace std;
using namespace FBB;
int main(int argc, char **argv)
{
if (argc == 1)
{
cout << "expect: nruns min max seed\n";
return 1;
}
Randbuffer rb(A2x(argv[2]), A2x(argv[3]), A2x(argv[4]).to<size_t>());
istream istr(&rb);
for (int idx = A2x(argv[1]); idx--; )
{
int c;
if (!(istr >> c))
{
cout << "extraction failed\n";
break;
}
cout << "next: " << c << endl;
}
int count = 0;
while (istr.unget())
count++;
cout << "number of successful unget()-calls: " << count << endl;
istr.clear();
istr >> count;
cout << "and read: " << count << endl;
return 0;
}
</pre>
<p>
<h2>FILES</h2>
<em>bobcat/randbuffer</em> - defines the class interface
<p>
<h2>SEE ALSO</h2>
<strong>bobcat</strong>(7), <strong>irandstream</strong>(3bobcat), <strong>rand</strong>(3), <strong>srand</strong>(3),
<strong>std::streambuf</strong>
<p>
<h2>BUGS</h2>
None Reported.
<p>
<h2>DISTRIBUTION FILES</h2>
<ul>
<li> <em>bobcat_2.20.01-x.dsc</em>: detached signature;
<li> <em>bobcat_2.20.01-x.tar.gz</em>: source archive;
<li> <em>bobcat_2.20.01-x_i386.changes</em>: change log;
<li> <em>libbobcat1_2.20.01-x_*.deb</em>: debian package holding the
libraries;
<li> <em>libbobcat1-dev_2.20.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>
|