/usr/share/doc/libbobcat2-dev/man/a2x.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 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 | <html><head>
<title>FBB::A2x</title>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1>FBB::A2x</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::A2x(3bobcat)</title>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1>FBB::A2x(3bobcat)</h1>
<h2>libbobcat1-dev_2.20.01-x.tar.gz Error handler</h2>
<h2>2005-2011</h2>
<p>
<h2>NAME</h2>FBB::A2x - Objects performing ascii-to-x (anything) conversions
<p>
<h2>SYNOPSIS</h2>
<strong>#include <bobcat/a2x></strong><br>
Linking option: <em>-lbobcat</em>
<p>
<h2>DESCRIPTION</h2>
<strong>FBB::A2x</strong> objects offer the <strong>C++</strong> equivalent of the standard <strong>C</strong>
conversion functions <strong>atoi</strong>(3), <strong>atol</strong>(3), <strong>atof</strong>(3) etc. <em>A2x</em>
objects generalize these <strong>C</strong> functions to <em>any</em> type that can be extracted
from an <strong>istream</strong> object. Since <strong>FBB::A2x</strong> represents the object-variant
of the <strong>C</strong> functions, and is therefore <em>type-safe</em> and <em>extensible</em>,
their use is greatly preferred over using the standard <strong>C</strong> functions.
<p>
<h2>NAMESPACE</h2>
<strong>FBB</strong><br>
All constructors, members, and operators, mentioned in this
man-page, are defined in the namespace <strong>FBB</strong>.
<p>
<h2>INHERITS FROM</h2>
<strong>std::istringstream</strong>
<p>
<h2>CONSTRUCTORS</h2>
<ul>
<li> <strong>A2x()</strong>:<br>
This constructor constructs an empty <em>A2x</em> object. No
information can be converted from a thus constructed <em>A2x</em> object.
<li> <strong>A2x(char const *text)</strong>:<br>
This constructor stores <em>text</em>. If <em>text</em> represents a textual
value of some type, the <em>A2x</em> object may be used to initialize or assign
this value to a variable of that particular type. Extraction, however is also
still possible.
<li> <strong>A2x(std::string const &str)</strong>:<br>
This constructor stores the text contained in <em>str</em>. If this text
represents a textual value of some type, the <em>A2x</em> object may be used to
initialize or assign this value to a variable of that particular
type. Extraction is also still possible.
</ul>
The copy constructor is available.
<p>
<h2>STATIC MEMBER FUNCTION</h2>
<ul>
<li> <strong>bool lastFail()</strong>:<br>
This member returns <em>true</em> if the last conversion failed (i.e., the
object's <em>fail()</em> member returned <em>true</em> and returns <em>false</em> otherwise).
This member allows checks on the success of the extraction/conversion using
anonymous <em>A2x</em> objects. The member also returns <em>true</em> when no
conversions have as yet been performed.<br>
Note that this member is a thread-unsafe <em>static</em> member: in a
multithreaded program locks may be required to ensure that the proper
conversion result is inspected.
</ul>
<p>
<h2>MEMBER FUNCTION</h2>
All members of the <strong>istringstream</strong> class are available.
<p>
<ul>
<li> <strong>Type to()</strong>:<br>
This member returns any type <em>Type</em> supporting extractions from
<em>i[string]streams</em>. If the extraction fails, the <em>A2x</em> object's
<em>good()</em> member will return <em>false</em>, and the <em>Type</em>'s default value is
returned. This operator was implemented as a template member function. There
is also a type conversion operator available (see below), but the member
function variant may be preferred over the conversion operator in situations
where explicit disambiguation is required (e.g., in cases where a
conversion has no obvious type solution such as direct insertions) An example
is provided in the <strong>EXAMPLE</strong> section below.
</ul>
<p>
<h2>OVERLOADED OPERATORS</h2>
<ul>
<li> <strong>operator Type()</strong>:<br>
Conversion to any type <em>Type</em> supporting
extractions from <em>i[string]streams</em>. If the extraction fails, the <em>A2x</em>
object's <em>good()</em> member will return <em>false</em>, and the <em>Type</em>'s default
value is returned. This operator was implemented as a template member
function.
<li> <strong>istream &operator>>(istream &, Type &)</strong>:<br>
Extraction to any type <em>Type</em> supporting extractions from
<em>i[string]streams</em>. If the extraction fails, the <em>A2x</em> object's
<em>good()</em> member will return <em>false</em>, and the <em>Type</em>'s default value is
returned (this facility is implied by the fact that this class inherits from
<strong>istringstream</strong>, but it's probably useful to stress that the extraction
operation is still available).
<li> <strong>A2x &operator=(char const *)</strong>:<br>
Stores new text in the <em>A2x</em> object, resets the status flags to
<em>ios::good</em>. If a 0-pointer is passed, an empty string is stored.
<li> <strong>A2x &operator=(std::string const &)</strong>:<br>
Stores the text stored in the <em>std::string</em> argument in the
<em>A2x</em> object, resets the status flags to <em>ios::good</em>.
<li> <strong>A2x &operator=(A2x const &)</strong>:<br>
The standard overloaded assignment operator is available
</ul>
<p>
<h2>EXAMPLE</h2>
<pre>
int x = A2x("12");
A2x a2x("12.50");
double d;
d = a2x;
a2x = "err";
d = a2x; // d now 0
a2x = " a";
char c = a2x; // c now 'a'
// explicit conversion to `double'
cout << A2x("12.4").to<double>() << endl;
</pre>
<p>
<h2>FILES</h2>
<em>bobcat/a2x</em> - defines the class interface
<p>
<h2>SEE ALSO</h2>
<strong>bobcat</strong>(7), <strong>x2a</strong>(3bobcat), <strong>atoi</strong>(3), <strong>atol</strong>(3), <strong>atof</strong>(3),
<strong>strtod</strong>(3), <strong>strtol</strong>(3), <strong>strdoul</strong>(3)
<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>
|