/usr/share/doc/libbobcat2-dev/man/hash.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 | <html><head>
<title>FBB::Hash</title>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1>FBB::Hash</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::Hash(3bobcat)</title>
<link rev="made" href="mailto:Frank B. Brokken: f.b.brokken@rug.nl">
</head>
<body text="#27408B" bgcolor="#FFFAF0">
<hr>
<h1>FBB::Hash(3bobcat)</h1>
<h2>libbobcat1-dev_2.20.01-x.tar.gz Key hashing containers</h2>
<h2>2005-2011</h2>
<p>
<h2>NAME</h2>FBB::Hash - Various mapping template classes using hashing
<p>
<h2>SYNOPSIS</h2>
<strong>#include <bobcat/hash></strong><br>
<p>
<h2>DESCRIPTION</h2>
The <strong>FBB:Hash</strong> group of template classes offer hashing-based
mapping. Various variants are availabe, 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<Key, Value></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<Value>()</strong>:<br> this hash table uses <em>case sensitive</em> <strong>char
const *</strong> keys;
<p>
<li> <strong>HashCharCasePtr<Value>()</strong>:<br> this hash table uses <em>case insensitive</em>
<strong>char const *</strong> keys;
<p>
<li> <strong>HashString<Value>()</strong>:<br> this hash table uses <em>case sensitive</em>
<strong>std::string</strong> keys;
<p>
<li> <strong>HashStringCase<Value>()</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 <iostream>
#include <bobcat/hash>
using namespace std;
using namespace FBB;
pair<char const *, size_t> ap[] =
{
pair<char const *, size_t>("one", 1),
pair<char const *, size_t>("two", 2),
};
int main()
{
HashCharPtr<size_t> hcp;
HashCharPtr<size_t> hcp2(ap, ap + 2);
HashCharPtr<size_t> hcp3(hcp2);
hcp = hcp2;
cout << hcp2["one"] << 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_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>
|