This file is indexed.

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


<p>
<h2 >NAME</h2>FBB::Hash - Various mapping template classes using hashing
<p>
<h2 >SYNOPSIS</h2>
    <strong >#include &lt;bobcat/hash&gt;</strong><br/>
<p>
<h2 >DESCRIPTION</h2>
    The <strong >FBB:Hash</strong> group of template classes offer hashing-based
mapping. Various variants are available, all based on the facilities offered by
the <strong >unordered_map</strong>.
<p>
The hash-map offered in the <strong >unordered_map</strong> container has a fairly
complex construction interface, and <em >Hash</em> is an attempt to simplify this
part of its interface. In practice, hashing uses a textual key, which may be
<strong >std::string</strong> or <em >char *</em> based, and the keys may be used either case
sensitively or case insensitively. <em >Hash</em> merely requires its users to
specify the map's value type, while the key may be a <em >char const *</em> or
<em >std::string</em>, used case sensitively or case insensitively.
<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::unordered_map</strong>, using various instantiations.
<p>
<h2 >TYPE</h2>
<p>
All variants define <em >value_type</em> as the corresponding <em >unordered_map
value_type</em>. In practice a <em >value_type</em> defines a <em >std::pair&lt;Key, Value&gt;</em>,
where <em >Key</em> represents the hash's key-type and <em >Value</em> represents the
hash's value type.
<p>
<h2 >CONSTRUCTORS</h2>
<p>
Variants of the <em >FBB::Hash</em> container are available for <em >char const *</em>
or <em >std::string</em> keys, used case sensitively or case insensitively. All
variants support default, copy, and move construction, support 
construction from initializer
lists and support construction from iterators defining a half-open range of
<em >value_type</em> values.
<p>
The following variants are available (showing their default
constructors). <em >Value</em> refers to the value type stored in the hash table.
<p>
<ul>
    <li> <strong >HashCharPtr&lt;Value&gt;()</strong>:<br/> this hash table uses <em >case sensitive</em> <strong >char
const *</strong> keys;
<p>
<li> <strong >HashCharCasePtr&lt;Value&gt;()</strong>:<br/> this hash table uses <em >case insensitive</em>
<strong >char const *</strong> keys;
<p>
<li> <strong >HashString&lt;Value&gt;()</strong>:<br/> this hash table uses <em >case sensitive</em>
<strong >std::string</strong> keys;
<p>
<li> <strong >HashStringCase&lt;Value&gt;()</strong>:<br/>  this hash table uses <em >case insensitive</em>
<strong >std::string</strong> keys;
    </ul>
<p>
<h2 >OVERLOADED OPERATOR</h2>
     In addition to the index operator inherited from <em >unordered_map</em> the
overloaded copy and move assignment operators are available for all <em >Hash</em>
containers.
<p>
<h2 >MEMBER FUNCTIONS</h2>
     All members of the <em >unordered_map</em> container are available, as <em >Hash</em>
inherits from this template class.
<p>
<h2 >EXAMPLE</h2>
        <pre>

    #include &lt;iostream&gt;
    #include &lt;bobcat/hash&gt;
    
    using namespace std;
    using namespace FBB;
    
    pair&lt;char const *, size_t&gt; ap[] =
    {
        pair&lt;char const *, size_t&gt;("one", 1),
        pair&lt;char const *, size_t&gt;("two", 2),
    };
    
    int main()
    {
        HashCharPtr&lt;size_t&gt; hcp;
        HashCharPtr&lt;size_t&gt; hcp2(ap, ap + 2);
        HashCharPtr&lt;size_t&gt; hcp3(hcp2);

        hcp = hcp2;
    
        cout &lt;&lt; hcp2["one"] &lt;&lt; endl;
    }
        
</pre>

<p>
<h2 >FILES</h2>
    <em >bobcat/hash</em> - defines the class interface
<p>
<h2 >SEE ALSO</h2>
    <strong >bobcat</strong>(7)
<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>