4 <!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
5 <!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
9 <meta name=
"viewport" content=
"width=device-width, initial-scale=1.0">
11 <title>Creating a hashkit structure
— libmemcached
1.0.99 documentation
</title>
20 <script type=
"text/javascript" src=
"../_static/js/modernizr.min.js"></script>
23 <script type=
"text/javascript" id=
"documentation_options" data-url_root=
"../" src=
"../_static/documentation_options.js"></script>
24 <script type=
"text/javascript" src=
"../_static/jquery.js"></script>
25 <script type=
"text/javascript" src=
"../_static/underscore.js"></script>
26 <script type=
"text/javascript" src=
"../_static/doctools.js"></script>
27 <script type=
"text/javascript" src=
"../_static/language_data.js"></script>
29 <script type=
"text/javascript" src=
"../_static/js/theme.js"></script>
34 <link rel=
"stylesheet" href=
"../_static/css/theme.css" type=
"text/css" />
35 <link rel=
"stylesheet" href=
"../_static/pygments.css" type=
"text/css" />
36 <link rel=
"index" title=
"Index" href=
"../genindex.html" />
37 <link rel=
"search" title=
"Search" href=
"../search.html" />
38 <link rel=
"copyright" title=
"Copyright" href=
"../copyright.html" />
39 <link rel=
"next" title=
"Set Hash Function" href=
"hashkit_function.html" />
40 <link rel=
"prev" title=
"libhashkit API" href=
"index.html" />
43 <body class=
"wy-body-for-nav">
46 <div class=
"wy-grid-for-nav">
48 <nav data-toggle=
"wy-nav-shift" class=
"wy-nav-side">
49 <div class=
"wy-side-scroll">
50 <div class=
"wy-side-nav-search" >
54 <a href=
"../index.html" class=
"icon icon-home"> libmemcached
71 <form id=
"rtd-search-form" class=
"wy-form" action=
"../search.html" method=
"get">
72 <input type=
"text" name=
"q" placeholder=
"Search docs" />
73 <input type=
"hidden" name=
"check_keywords" value=
"yes" />
74 <input type=
"hidden" name=
"area" value=
"default" />
81 <div class=
"wy-menu wy-menu-vertical" data-spy=
"affix" role=
"navigation" aria-label=
"main navigation">
88 <p class=
"caption"><span class=
"caption-text">libmemcached
</span></p>
90 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcached.html">Introduction
</a></li>
91 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcached/index.html">libmemcached API
</a></li>
92 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcached/index_misc.html">Misc
</a></li>
94 <p class=
"caption"><span class=
"caption-text">libmemcachedutil
</span></p>
96 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcachedutil.html">Introduction
</a></li>
97 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcachedutil/index.html">libmemcachedutil API
</a></li>
99 <p class=
"caption"><span class=
"caption-text">libhashkit
</span></p>
101 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libhashkit.html">Introduction
</a></li>
102 <li class=
"toctree-l1 current"><a class=
"reference internal" href=
"index.html">libhashkit API
</a><ul class=
"current">
103 <li class=
"toctree-l2 current"><a class=
"current reference internal" href=
"#">Creating a hashkit structure
</a></li>
104 <li class=
"toctree-l2"><a class=
"reference internal" href=
"hashkit_function.html">Set Hash Function
</a></li>
105 <li class=
"toctree-l2"><a class=
"reference internal" href=
"hashkit_functions.html">Available Hashes
</a></li>
106 <li class=
"toctree-l2"><a class=
"reference internal" href=
"hashkit_value.html">Generate hash value
</a></li>
110 <p class=
"caption"><span class=
"caption-text">Client Applications
</span></p>
112 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../bin/index.html">Client Applications
</a></li>
114 <p class=
"caption"><span class=
"caption-text">Copyright
</span></p>
116 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../copyright.html">Copyright
</a></li>
125 <section data-toggle=
"wy-nav-shift" class=
"wy-nav-content-wrap">
128 <nav class=
"wy-nav-top" aria-label=
"top navigation">
130 <i data-toggle=
"wy-nav-top" class=
"fa fa-bars"></i>
131 <a href=
"../index.html">libmemcached
</a>
136 <div class=
"wy-nav-content">
138 <div class=
"rst-content">
156 <div role=
"navigation" aria-label=
"breadcrumbs navigation">
158 <ul class=
"wy-breadcrumbs">
160 <li><a href=
"../index.html">Docs
</a> »</li>
162 <li><a href=
"index.html">libhashkit API
</a> »</li>
164 <li>Creating a hashkit structure
</li>
167 <li class=
"wy-breadcrumbs-aside">
178 <div role=
"main" class=
"document" itemscope=
"itemscope" itemtype=
"http://schema.org/Article">
179 <div itemprop=
"articleBody">
181 <div class=
"section" id=
"creating-a-hashkit-structure">
182 <h1>Creating a hashkit structure
<a class=
"headerlink" href=
"#creating-a-hashkit-structure" title=
"Permalink to this headline">¶
</a></h1>
183 <div class=
"section" id=
"synopsis">
184 <h2>SYNOPSIS
<a class=
"headerlink" href=
"#synopsis" title=
"Permalink to this headline">¶
</a></h2>
185 <dl class=
"docutils">
186 <dt>#include
<libhashkit-
1.0/hashkit.h
></dt>
187 <dd>Compile and link with -lhashkit
</dd>
190 <dt id=
"_CPPv410hashkit_st">
191 <span id=
"_CPPv310hashkit_st"></span><span id=
"_CPPv210hashkit_st"></span><span id=
"hashkit_st"></span><em class=
"property">typedef
</em><em class=
"property">struct
</em> <a class=
"reference internal" href=
"#_CPPv410hashkit_st" title=
"hashkit_st">hashkit_st
</a> <code class=
"descname">hashkit_st
</code><a class=
"headerlink" href=
"#_CPPv410hashkit_st" title=
"Permalink to this definition">¶
</a><br /></dt>
194 <dl class=
"function">
195 <dt id=
"_CPPv414hashkit_createP10hashkit_st">
196 <span id=
"_CPPv314hashkit_createP10hashkit_st"></span><span id=
"_CPPv214hashkit_createP10hashkit_st"></span><span id=
"hashkit_create__hashkit_stP"></span><a class=
"reference internal" href=
"#_CPPv410hashkit_st" title=
"hashkit_st">hashkit_st
</a> *
<code class=
"descname">hashkit_create
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"#_CPPv410hashkit_st" title=
"hashkit_st">hashkit_st
</a> *
<em>hash
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv414hashkit_createP10hashkit_st" title=
"Permalink to this definition">¶
</a><br /></dt>
197 <dd><table class=
"docutils field-list" frame=
"void" rules=
"none">
198 <col class=
"field-name" />
199 <col class=
"field-body" />
201 <tr class=
"field-odd field"><th class=
"field-name">Parameters:
</th><td class=
"field-body"><strong>hash
</strong> -- memory address of a
<a class=
"reference internal" href=
"#_CPPv410hashkit_st" title=
"hashkit_st"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_st
</span></code></a> struct;
202 if a nullptr is passed, the struct will be dynamically allocated by libhashkit
</td>
204 <tr class=
"field-even field"><th class=
"field-name">Returns:
</th><td class=
"field-body">pointer to initialized
<a class=
"reference internal" href=
"#_CPPv410hashkit_st" title=
"hashkit_st"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_st
</span></code></a> structure
</td>
210 <dl class=
"function">
211 <dt id=
"_CPPv413hashkit_cloneP10hashkit_stPK10hashkit_st">
212 <span id=
"_CPPv313hashkit_cloneP10hashkit_stPK10hashkit_st"></span><span id=
"_CPPv213hashkit_cloneP10hashkit_stPK10hashkit_st"></span><span id=
"hashkit_clone__hashkit_stP.hashkit_stCP"></span><a class=
"reference internal" href=
"#_CPPv410hashkit_st" title=
"hashkit_st">hashkit_st
</a> *
<code class=
"descname">hashkit_clone
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"#_CPPv410hashkit_st" title=
"hashkit_st">hashkit_st
</a> *
<em>destination
</em>,
<em class=
"property">const
</em> <a class=
"reference internal" href=
"#_CPPv410hashkit_st" title=
"hashkit_st">hashkit_st
</a> *
<em>ptr
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv413hashkit_cloneP10hashkit_stPK10hashkit_st" title=
"Permalink to this definition">¶
</a><br /></dt>
213 <dd><table class=
"docutils field-list" frame=
"void" rules=
"none">
214 <col class=
"field-name" />
215 <col class=
"field-body" />
217 <tr class=
"field-odd field"><th class=
"field-name">Parameters:
</th><td class=
"field-body"><ul class=
"first simple">
218 <li><strong>destination
</strong> -- memory address of a
<a class=
"reference internal" href=
"#_CPPv410hashkit_st" title=
"hashkit_st"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_st
</span></code></a> struct;
219 if a nullptr is passed, the struct will be dynamically allocated by libhashkit
</li>
220 <li><strong>ptr
</strong> -- pointer of the
<a class=
"reference internal" href=
"#_CPPv410hashkit_st" title=
"hashkit_st"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_st
</span></code></a> struct to copy
</li>
224 <tr class=
"field-even field"><th class=
"field-name">Returns:
</th><td class=
"field-body"><p class=
"first last">pointer to a
<a class=
"reference internal" href=
"#_CPPv410hashkit_st" title=
"hashkit_st"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_st
</span></code></a> structure (
<a class=
"reference internal" href=
"#_CPPv413hashkit_cloneP10hashkit_stPK10hashkit_st" title=
"hashkit_clone::destination"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">destination
</span></code></a>, if not nullptr), initialized from
<a class=
"reference internal" href=
"#_CPPv413hashkit_cloneP10hashkit_stPK10hashkit_st" title=
"hashkit_clone::ptr"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">ptr
</span></code></a></p>
231 <dl class=
"function">
232 <dt id=
"_CPPv412hashkit_freeP10hashkit_st">
233 <span id=
"_CPPv312hashkit_freeP10hashkit_st"></span><span id=
"_CPPv212hashkit_freeP10hashkit_st"></span><span id=
"hashkit_free__hashkit_stP"></span>void
<code class=
"descname">hashkit_free
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"#_CPPv410hashkit_st" title=
"hashkit_st">hashkit_st
</a> *
<em>hash
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv412hashkit_freeP10hashkit_st" title=
"Permalink to this definition">¶
</a><br /></dt>
234 <dd><table class=
"docutils field-list" frame=
"void" rules=
"none">
235 <col class=
"field-name" />
236 <col class=
"field-body" />
238 <tr class=
"field-odd field"><th class=
"field-name">Parameters:
</th><td class=
"field-body"><strong>hash
</strong> -- pointer to an initialized
<a class=
"reference internal" href=
"#_CPPv410hashkit_st" title=
"hashkit_st"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_st
</span></code></a> struct
</td>
244 <dl class=
"function">
245 <dt id=
"_CPPv420hashkit_is_allocatedPK10hashkit_st">
246 <span id=
"_CPPv320hashkit_is_allocatedPK10hashkit_st"></span><span id=
"_CPPv220hashkit_is_allocatedPK10hashkit_st"></span><span id=
"hashkit_is_allocated__hashkit_stCP"></span>bool
<code class=
"descname">hashkit_is_allocated
</code><span class=
"sig-paren">(
</span><em class=
"property">const
</em> <a class=
"reference internal" href=
"#_CPPv410hashkit_st" title=
"hashkit_st">hashkit_st
</a> *
<em>hash
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv420hashkit_is_allocatedPK10hashkit_st" title=
"Permalink to this definition">¶
</a><br /></dt>
247 <dd><table class=
"docutils field-list" frame=
"void" rules=
"none">
248 <col class=
"field-name" />
249 <col class=
"field-body" />
251 <tr class=
"field-odd field"><th class=
"field-name">Parameters:
</th><td class=
"field-body"><strong>hash
</strong> -- pointer to an initialized
<a class=
"reference internal" href=
"#_CPPv410hashkit_st" title=
"hashkit_st"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_st
</span></code></a> struct
</td>
253 <tr class=
"field-even field"><th class=
"field-name">Returns:
</th><td class=
"field-body">bool, whether the
<a class=
"reference internal" href=
"#_CPPv420hashkit_is_allocatedPK10hashkit_st" title=
"hashkit_is_allocated::hash"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hash
</span></code></a> struct was dynamically allocated
</td>
260 <div class=
"section" id=
"description">
261 <h2>DESCRIPTION
<a class=
"headerlink" href=
"#description" title=
"Permalink to this headline">¶
</a></h2>
262 <p>The
<a class=
"reference internal" href=
"#_CPPv414hashkit_createP10hashkit_st" title=
"hashkit_create"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_create()
</span></code></a> function initializes a hashkit object for use. If you pass
263 a nullptr argument for hash, then the memory for the object is allocated. If you
264 specify a pre-allocated piece of memory, that is initialized for use.
</p>
265 <p>The
<a class=
"reference internal" href=
"#_CPPv413hashkit_cloneP10hashkit_stPK10hashkit_st" title=
"hashkit_clone"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_clone()
</span></code></a> function initializes a hashkit object much like
266 <a class=
"reference internal" href=
"#_CPPv414hashkit_createP10hashkit_st" title=
"hashkit_create"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_create()
</span></code></a>, but instead of using default settings it will use the settings
267 of the ptr hashkit object.
</p>
268 <p>The
<a class=
"reference internal" href=
"#_CPPv412hashkit_freeP10hashkit_st" title=
"hashkit_free"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_free()
</span></code></a> frees any resources being consumed by the hashkit objects
269 that were initialized with
<a class=
"reference internal" href=
"#_CPPv414hashkit_createP10hashkit_st" title=
"hashkit_create"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_create()
</span></code></a> or
<a class=
"reference internal" href=
"#_CPPv413hashkit_cloneP10hashkit_stPK10hashkit_st" title=
"hashkit_clone"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_clone()
</span></code></a>.
</p>
270 <p>The
<a class=
"reference internal" href=
"#_CPPv420hashkit_is_allocatedPK10hashkit_st" title=
"hashkit_is_allocated"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_is_allocated()
</span></code></a> reports whether the memory was allocated for a hashkit
273 <div class=
"section" id=
"return-value">
274 <h2>RETURN VALUE
<a class=
"headerlink" href=
"#return-value" title=
"Permalink to this headline">¶
</a></h2>
275 <p><a class=
"reference internal" href=
"#_CPPv414hashkit_createP10hashkit_st" title=
"hashkit_create"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_create()
</span></code></a> and
<a class=
"reference internal" href=
"#_CPPv413hashkit_cloneP10hashkit_stPK10hashkit_st" title=
"hashkit_clone"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_clone()
</span></code></a> will return nullptr on failure or pointer
276 to
<a class=
"reference internal" href=
"#_CPPv410hashkit_st" title=
"hashkit_st"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_st
</span></code></a> on success.
</p>
277 <p><a class=
"reference internal" href=
"#_CPPv420hashkit_is_allocatedPK10hashkit_st" title=
"hashkit_is_allocated"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_is_allocated()
</span></code></a> returns true if the memory for the hashkit object was
278 allocated inside of
<a class=
"reference internal" href=
"#_CPPv414hashkit_createP10hashkit_st" title=
"hashkit_create"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_create()
</span></code></a> or
<a class=
"reference internal" href=
"#_CPPv413hashkit_cloneP10hashkit_stPK10hashkit_st" title=
"hashkit_clone"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">hashkit_clone()
</span></code></a>, otherwise it is false
279 and was user-supplied memory.
</p>
281 <div class=
"section" id=
"see-also">
282 <h2>SEE ALSO
<a class=
"headerlink" href=
"#see-also" title=
"Permalink to this headline">¶
</a></h2>
284 <li><a class=
"reference internal" href=
"../libhashkit.html"><span class=
"doc">libhashkit - C/C++ hashing library
</span></a></li>
285 <li><a class=
"reference internal" href=
"hashkit_value.html"><span class=
"doc">Generate hash value
</span></a></li>
286 <li><a class=
"reference internal" href=
"hashkit_function.html"><span class=
"doc">Set Hash Function
</span></a></li>
297 <div class=
"rst-footer-buttons" role=
"navigation" aria-label=
"footer navigation">
299 <a href=
"hashkit_function.html" class=
"btn btn-neutral float-right" title=
"Set Hash Function" accesskey=
"n" rel=
"next">Next
<span class=
"fa fa-arrow-circle-right"></span></a>
302 <a href=
"index.html" class=
"btn btn-neutral float-left" title=
"libhashkit API" accesskey=
"p" rel=
"prev"><span class=
"fa fa-arrow-circle-left"></span> Previous
</a>
309 <div role=
"contentinfo">
311 © <a href=
"../copyright.html">Copyright
</a>
315 Built with
<a href=
"http://sphinx-doc.org/">Sphinx
</a> using a
<a href=
"https://github.com/rtfd/sphinx_rtd_theme">theme
</a> provided by
<a href=
"https://readthedocs.org">Read the Docs
</a>.
328 <script type=
"text/javascript">
330 SphinxRtdTheme.Navigation.enable(true);