/usr/share/doc/libbobcat2-dev/man/iostream.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 | <html><head>
<title>FBB::IOStream</title>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1>FBB::IOStream</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::IOStream(3bobcat)</title>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1>FBB::IOStream(3bobcat)</h1>
<h2>libbobcat1-dev_2.20.01-x.tar.gz std::istream and std::ostream</h2>
<h2>2005-2011</h2>
<p>
<h2>NAME</h2>FBB::IOStream - Combines std::istream and std::ostream features
<p>
<h2>SYNOPSIS</h2>
<strong>#include <bobcat/iostream></strong><br>
Linking option: <em>-lbobcat</em>
<p>
<h2>DESCRIPTION</h2>
<p>
This class combines the features of the <strong>std::istream</strong> and
<strong>std::ostream</strong> classes. The <strong>std::istream</strong> and <strong>std::ostream</strong> may be
physically different streams. <strong>FBB:IOStream</strong> objects may, e.g., be
associated with streams wrapped around <em>pipes</em> (see, e.g.,
<strong>FBB::IfdStream</strong> and <strong>FBB::OFdStream</strong>), to construct bi-directional pipes.
<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>FBB::IOStreambuf</strong> (private inheritance),<br>
<strong>std::istream</strong>,<br>
<strong>std::ostream</strong>
<p>
<h2>CONSTRUCTORS</h2>
<ul>
<li> <strong>IOStream()</strong>:<br>
The default constructor constructs an empty <strong>FBB::IOStream</strong>
objects. It should not be used before its <em>open</em> member (see below) was
called.
<li> <strong>IOStream(std::istream &in, std::ostream &out)</strong>:<br>
This constructor associates the <strong>IOStream</strong> object with a
<em>std::istream</em> and a <em>std::ostream</em>. All output operations will be passed
on to the <em>std::ostream</em>, all input operations to the <em>std::istream</em>. The
streams passed to <em>IOStream</em> should outlive the <strong>IOStream</strong> object. This
constructor performs the actions of the default constructor and then calls the
<em>IOStream::open</em> member
</ul>
De copy constructor is available as well.
<p>
<h2>MEMBER FUNCTIONS</h2>
All members of <em>std::istream</em> and <em>std::ostream</em> are
available, as <strong>FBB::IOStream</strong> inherits from these classes. Furthermore, when
switching between <em>std::istream</em> and <em>std::ostream</em> operations, no
intermediate <em>seekg()</em> or <em>seekp()</em> operation will normally be required,
since the base classes will normally be associated with physically different
streams.
<ul>
<li> <strong>void open(std::istream &in, std::ostream &out)</strong>:<br>
This member (re)associates the <strong>IOStream</strong> object with a
<em>std::istream</em> and a <em>std::ostream</em>. All output operations will be passed
on to the <em>std::ostream</em>, all input operations to the <em>std::istream</em>. The
streams passed to <em>IOStream()</em> should outlive the <strong>IOStream</strong> object. If
this member is called for an <strong>IOStream</strong> object already associated with an
<em>std::ostream</em> object, the already associated <em>std::ostream</em> object is
flushed before setting up the new association.
<li> <strong>void clear()</strong>:<br>
This member clears the error states of the associated <em>std::istream</em>
and <em>std::ostream</em> objects.
</ul>
<p>
<h2>EXAMPLE</h2>
See the example provided with <strong>process</strong>(3bobcat).
<p>
<h2>FILES</h2>
<em>bobcat/iostream</em> - defines the class interface
<p>
<h2>SEE ALSO</h2>
<strong>bobcat</strong>(7), <strong>ifdstream</strong>(3bobcat), <strong>iostreambuf</strong>(3bobcat),
<strong>ofdstream</strong>(3bobcat), <strong>process</strong>(3bobcat)
<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>
|