/usr/share/doc/libbobcat3-dev/man/tempstream.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 | <html><head>
<title>FBB::TempStream</title>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1>FBB::TempStream</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::TempStream(3bobcat)</title>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1>FBB::TempStream(3bobcat)</h1>
<h2>libbobcat-dev_3.19.01-x.tar.gz Temporary fstream</h2>
<h2>2005-2013</h2>
<p>
<h2>NAME</h2>FBB::TempStream - Temporary fstream
<p>
<h2>SYNOPSIS</h2>
<strong>#include <bobcat/tempstream></strong><br>
<p>
<h2>DESCRIPTION</h2>
<strong>FBB::TempStream</strong> objects are temporary <em>std::fstreams</em> opened with
mode 0600 (user only read+write). The file created by a <em>TempStream</em> object
is removed from the file system once the <em>TempStream</em> object goes out of
scope.
<p>
A <em>TempStream</em> object creates an empty file, and information can
immediately be inserted into the <em>TempStream</em> object. To switch between
insertion and extraction simply call <em>seekg</em> (for extraction) or <em>seekp</em>
(for insertion).
<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>std::fstream</strong>
<p>
<h2>CONSTRUCTORS</h2>
<ul>
<li> <strong>TempStream(std::string const &base = "/tmp/FBB::TempStream")</strong>:<br>
The constructor initializes the object and creates a file with the
given base-name to which six random characters are appended. If the
<em>TempStream</em> could not be constructed an <em>FBB::Exception</em> exception is thrown.
</ul>
The copy constructor is not available.
<p>
<h2>MEMBER FUNCTIONS</h2>
All <strong>std::fstream</strong> members are available, as <strong>FBB::TempStream</strong>
inherits from this class. In addition, <em>TempStream</em> itself offers
<ul>
<li> <strong>std::string const &fileName() const</strong>:<br>
The name of the created temporary file.
</ul>
<p>
<h2>EXAMPLE</h2>
<pre>
#include <iostream>
#include <bobcat/tempstream>
using namespace std;
using namespace FBB;
int main()
{
TempStream ts("/tmp/demo");
ts << "Hello world\n";
ts.seekg(0);
string line;
getline(ts, line);
cout << line << ", removed: " << ts.fileName() << '\n';
}
</pre>
<p>
<h2>FILES</h2>
<em>bobcat/tempstream</em> - defines the class interface
<p>
<h2>SEE ALSO</h2>
<strong>bobcat</strong>(7), <strong>mkostemp</strong>(3)
<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>
|