/usr/share/doc/libbobcat4-dev/man/ibase64streambuf.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 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 | <!DOCTYPE html><html><head>
<meta charset="UTF-8">
<title>FBB::IBase64Streambuf(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::IBase64Streambuf(3bobcat)</h1>
<h2 id="author">Base64 converting Stream Buffer<br/>(libbobcat-dev_4.08.02-x.tar.gz)</h2>
<h2 id="date">2005-2017</h2>
<p>
<h2 >NAME</h2>FBB::IBase64Streambuf - Input Filtering stream buffer doing base64 conversion
<p>
<h2 >SYNOPSIS</h2>
<strong >#include <bobcat/ibase64streambuf></strong><br/>
Linking option: <em >-lbobcat</em>
<p>
<h2 >DESCRIPTION</h2>
The information made available by <strong >IBase64Streambuf</strong> objects has been
subject to base64 encoding or decoding. The information to be converted is
made available to <strong >IBase64Streambuf</strong> object via <em >std::istream</em> objects.
<p>
The <em >class IBase64Streambuf</em> is a class template, using a
<em >FBB::CryptType</em> template non-type parameter. Objects of the class
<em >FBB::IBase64Streambuf<FBB::ENCRYPT></em> base64 encode the information they
receive, objects of the class <em >FBB::IBase64Streambuf<FBB::DECRYPT></em> base64
decode the information they receive. See also section <strong >ENUMERATION</strong> below.
<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::IFilterStreambuf</strong>
<p>
<h2 >MEMBER FUNCTIONS</h2>
All members of <strong >FBB::IFilterStreambuf</strong> are available, as
<strong >IBase64Streambuf</strong> inherits from this class.
<p>
Overloaded move and/or copy assignment operators are not available.
<p>
<h2 >ENUMERATION</h2>
<p>
<strong >IBase64Streambuf</strong> objects either base64 encode or decode
information. <strong >IBase64Streambuf</strong> objects of the class
<strong >FBB::IBase64Streambuf<FBB::ENCRYPT></strong> base64 encode the data they receive,
<strong >IBase64Streambuf</strong> objects of the class
<strong >FBB::IBase64Streambuf<FBB::DECRYPT></strong> base64 decode the data they receive.
<p>
The values <em >ENCRYPT</em> and <em >DECRYPT</em> are defined in the <em >enum CryptType</em>,
which is defined in the <em >FBB</em> namespace.
<p>
<h2 >CONSTRUCTOR</h2>
<ul>
<li> <strong >IBase64Streambuf<CryptType>(std::istream &in, size_t bufSize = 1000)</strong>:<br/>
This constructor initializes the streambuf.
<p>
- <em >IBase64Streambuf<ENCRYPT></em> objects perform base64 encoding;<br/>
- <em >IBase64Streambuf<DECRYPT></em> objects perform base64 decoding;<br/>
- <em >IBase64Streambuf<CryptType></em> objects obtain the bytes to encode or
decode from <em >std::istream &in</em>;<br/>
- The <em >IFilterStreambuf</em> base class is initialized with a buffer of
size <em >bufSize</em>, using a lower bound of 100.
<p>
The constructor uses a configurable buffer size for reading. Characters
that were read into the buffer but are not part of the actual base64 encoded
data are unavailable after completing the base64 decrypting. If information
beyond the base64 input block should remain available, then specify a
buffer size of 1.
</ul>
<p>
Copy- and move constructors are not available.
<p>
<h2 >EXAMPLE</h2>
<p>
The example shows the construction of <em >IBase64Streambuf<ENCRYPT></em>
objects <em >encode</em> which are used to initialize a <em >std::istream</em> object. The
information read from this <em >istream</em> is base64 encoded.
<p>
<em >IBase64Streambuf<DECRYPT></em> objects (<em >decode</em> reads base64 encoded
information from <em >std::istream</em> objects and decodes it again).
<p>
The <em >std::istream din</em> object is initialized with the
<em >IBase64Streambuf<DECRYPT></em> object, and its contents is sent to
<em >std::cout</em>. The information that is presented at <em >std::cin</em> and that
appears at <em >std::cout</em> should be identical.
<p>
<pre >
#include <iostream>
#include <istream>
#include <bobcat/ibase64streambuf>
using namespace std;
using namespace FBB;
int main(int argc, char **argv)
{
switch (argv[1][0])
{
case 'e':
{
IBase64Streambuf<ENCRYPT> encode(cin);
istream ein(&encode);
cout << ein.rdbuf();
}
break;
case 'd':
{
IBase64Streambuf<DECRYPT> decode(cin);
istream din(&decode);
cout << din.rdbuf();
}
break;
case 'b':
{
IBase64Streambuf<ENCRYPT> encode(cin);
istream ein(&encode);
IBase64Streambuf<DECRYPT> decode(ein);
istream din(&decode);
cout << din.rdbuf();
}
break;
default:
cout << "Usage: " << argv[0] << " [edb] < infile > outfile\n"
"to base64 -e-ncode, -d-ecode or -b-oth\n";
break;
}
}
</pre>
<p>
<h2 >FILES</h2>
<em >bobcat/ibase64streambuf</em> - defines the class interface
<p>
<h2 >SEE ALSO</h2>
<strong >bobcat</strong>(7), <strong >isymcryptstreambuf</strong>(3bobcat),
<strong >ibase64stream</strong>(3bobcat), <strong >ifilterstreambuf</strong>(3bobcat),
<strong >ofilterstreambuf</strong>(3bobcat), <strong >std::streambuf</strong>.
<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>
|