This file is indexed.

/usr/share/doc/libbobcat4-dev/man/a2x.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
<!DOCTYPE html><html><head>
<meta charset="UTF-8">
<title>FBB::A2x(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::A2x(3bobcat)</h1>
<h2 id="author">Error handler<br/>(libbobcat-dev_4.08.02-x.tar.gz)</h2>
<h2 id="date">2005-2017</h2>


<p>
<h2 >NAME</h2>FBB::A2x - Objects performing ascii-to-x (anything) conversions
<p>
<h2 >SYNOPSIS</h2>
    <strong >#include &lt;bobcat/a2x&gt;</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>
Conversions to most standard numeric types is also available through
functions like <em >std::stol, std::stod</em>, etc.
<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 &amp;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 &amp;operator&gt;&gt;(istream &amp;, Type &amp;)</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 &amp;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 &amp;operator=(std::string const &amp;)</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 &amp;operator=(A2x const &amp;)</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 &lt;&lt; A2x("12.4").to&lt;double&gt;() &lt;&lt; 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_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>