This file is indexed.

/usr/share/doc/libbobcat3/man/randbuffer.3.html is in libbobcat-dev 3.23.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>libbobcat-dev_3.23.01-x.tar.gz</h2>
<h2>2005-2014</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>libbobcat-dev_3.23.01-x.tar.gz random number streambuf</h2>
<h2>2005-2014</h2>


<p>
<h2>NAME</h2>FBB::RandBuffer - std::streambuf generating random numbers
<p>
<h2>SYNOPSIS</h2>
    <strong>#include &lt;bobcat/randbuffer&gt;</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 &lt;iostream&gt;
#include &lt;istream&gt;

#include &lt;bobcat/randbuffer&gt;
#include &lt;bobcat/a2x&gt;

using namespace std;
using namespace FBB;

int main(int argc, char **argv)
{
    if (argc == 1)
    {
        cout &lt;&lt; "expect: nruns min max seed\n";
        return 1;
    }

    Randbuffer rb(A2x(argv[2]), A2x(argv[3]), A2x(argv[4]).to&lt;size_t&gt;());

    istream istr(&amp;rb);

    for (int idx = A2x(argv[1]); idx--; )
    {
        int c;
        if (!(istr &gt;&gt; c))
        {
            cout &lt;&lt; "extraction failed\n";
            break;
        }    
        cout &lt;&lt; "next: " &lt;&lt; c &lt;&lt; endl;
    }

    int count = 0;
    while (istr.unget())
        count++;

    cout &lt;&lt; "number of successful unget()-calls: " &lt;&lt; count &lt;&lt; endl;
    istr.clear();
    istr &gt;&gt; count;
    cout &lt;&lt; "and read: " &lt;&lt; count &lt;&lt; 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_3.23.01-x.dsc</em>: detached signature;
    <li> <em>bobcat_3.23.01-x.tar.gz</em>: source archive;
    <li> <em>bobcat_3.23.01-x_i386.changes</em>: change log;
    <li> <em>libbobcat1_3.23.01-x_*.deb</em>: debian package holding the
            libraries;
    <li> <em>libbobcat1-dev_3.23.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>