/usr/share/doc/libbobcat3-dev/man/stringline.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 | <html><head>
<title>FBB::StringLine</title>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1>FBB::StringLine</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::StringLine(3bobcat)</title>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1>FBB::StringLine(3bobcat)</h1>
<h2>libbobcat-dev_3.19.01-x.tar.gz Line extractor</h2>
<h2>2005-2013</h2>
<p>
<h2>NAME</h2>FBB::StringLine - extracting lines using operator>>
<p>
<h2>SYNOPSIS</h2>
<strong>#include <bobcat/stringline></strong><br>
<p>
<h2>DESCRIPTION</h2>
The standard <em>operator>>(std::istream &, std::string &)</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 &, std::string &)</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>></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 &operator>>(std::istream &in, StringLine &str)</strong>:<br>
The extraction operator returns the next line on <em>in</em> in <em>str</em>,
calling <em>getline(std::istream &, std::string &)</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<std::string> lines</em>:
<pre>
#include <iostream>
#include <algorithm>
#include <iterator>
#include <vector>
#include <bobcat/stringline>
using namespace std;
using namespace FBB;
int main()
{
vector<string> lines;
copy(
istream_iterator<StringLine>(cin), istream_iterator<StringLine>(),
back_inserter(lines)
);
}
</pre>
<p>
<h2>FILES</h2>
<em>bobcat/stringline</em> - defines the class interface and
<em>operator>></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_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>
|