This file is indexed.

/usr/share/doc/libbobcat4-dev/man/stringline.3.html is in libbobcat-dev 4.08.02-2build1.

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
<!DOCTYPE html><html><head>
<meta charset="UTF-8">
<title>FBB::StringLine(3bobcat)</title>
<style type="text/css">
    figure {text-align: center;}
    img {vertical-align: center;}
    .XXfc {margin-left:auto;margin-right:auto;}
    .XXtc {text-align: center;}
    .XXtl {text-align: left;}
    .XXtr {text-align: right;}
    .XXvt {vertical-align: top;}
    .XXvb {vertical-align: bottom;}
</style>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr/>
<h1 id="title">FBB::StringLine(3bobcat)</h1>
<h2 id="author">Line extractor<br/>(libbobcat-dev_4.08.02-x.tar.gz)</h2>
<h2 id="date">2005-2017</h2>


<p>
<h2 >NAME</h2>FBB::StringLine - extracting lines using operator&gt;&gt;
<p>
<h2 >SYNOPSIS</h2>
    <strong >#include &lt;bobcat/stringline&gt;</strong><br/>
<p>
<h2 >DESCRIPTION</h2>
    The standard <em >operator&gt;&gt;(std::istream &amp;, std::string &amp;)</em> string
extracion operator extracts the first `word' from a stream. In cases where the
intent it to extract lines from the stream this operator cannot be used, but
<em >getline(std::istream &amp;, std::string &amp;)</em> is usually called. 
<p>
However, <em >getline</em> is not called by many tools of generic algorithms,
like the <em >istream_iterator</em>. 
<p>
The class (actually: struct) <em >StringLine</em> was simply derived from
<em >std::string</em>, and defines its own <em >operator&gt;&gt;</em>, reading the next line
from the specified <em >std::istream</em>. 
<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>
    <em >std::string</em>
<p>
<h2 >CONSTRUCTORS</h2>
    <em >StringLine</em> is an empty shell around <em >std::string</em>. It does not
explicitly define constructors. The default and copy constructors are
available. 
<p>
<h2 >OVERLOADED OPERATOR</h2>
    <ul>    
    <li> <strong >std::istream &amp;operator&gt;&gt;(std::istream &amp;in, StringLine &amp;str)</strong>:<br/>
        The extraction operator returns the next line on <em >in</em> in <em >str</em>,
        calling <em >getline(std::istream &amp;, std::string &amp;)</em>.
    </ul>
<p>
<h2 >MEMBER FUNCTIONS</h2>
     All members of <strong >std::string</strong> are
available, as <strong >FBB::StringLine</strong> inherits from these classes.
<p>
<h2 >EXAMPLE</h2>
    The following example extracts all lines from <em >std::cin</em> and adds them
to the <em >std::vector&lt;std::string&gt; lines</em>:
        <pre>

#include &lt;iostream&gt;
#include &lt;algorithm&gt;
#include &lt;iterator&gt;
#include &lt;vector&gt;
#include &lt;bobcat/stringline&gt;

using namespace std;
using namespace FBB;

int main()
{
    vector&lt;string&gt; lines;
    
    copy(
        istream_iterator&lt;StringLine&gt;(cin), istream_iterator&lt;StringLine&gt;(), 
        back_inserter(lines)
    );
}
        
</pre>

<p>
<h2 >FILES</h2>
    <em >bobcat/stringline</em> - defines the class interface and
<em >operator&gt;&gt;</em>. 
<p>
There are <em >StringLine</em> object files in the Bobcat library,
so linking to Bobcat when using <em >StringLine</em> is not necessary.
<p>
<h2 >SEE ALSO</h2>
    <strong >bobcat</strong>(7)
<p>
<h2 >BUGS</h2>
    None Reported.
<p>

<h2 >DISTRIBUTION FILES</h2>
    <ul>
    <li> <em >bobcat_4.08.02-x.dsc</em>: detached signature;
    <li> <em >bobcat_4.08.02-x.tar.gz</em>: source archive;
    <li> <em >bobcat_4.08.02-x_i386.changes</em>: change log;
    <li> <em >libbobcat1_4.08.02-x_*.deb</em>: debian package holding the
            libraries;
    <li> <em >libbobcat1-dev_4.08.02-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>
</body>
</html>