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>Working with memcached pools
— 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 src=
"../_static/jquery.js"></script>
25 <script src=
"../_static/underscore.js"></script>
26 <script src=
"../_static/doctools.js"></script>
27 <script 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=
"libhashkit - C/C++ hashing library" href=
"../libhashkit.html" />
40 <link rel=
"prev" title=
"libmemcachedutil 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 current"><a class=
"reference internal" href=
"index.html">libmemcachedutil API
</a><ul class=
"current">
98 <li class=
"toctree-l2 current"><a class=
"current reference internal" href=
"#">Working with memcached pools
</a></li>
102 <p class=
"caption"><span class=
"caption-text">libhashkit
</span></p>
104 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libhashkit.html">Introduction
</a></li>
105 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libhashkit/index.html">libhashkit API
</a></li>
107 <p class=
"caption"><span class=
"caption-text">Client Applications
</span></p>
109 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../bin/index.html">Client Applications
</a></li>
111 <p class=
"caption"><span class=
"caption-text">Copyright
</span></p>
113 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../copyright.html">Copyright
</a></li>
122 <section data-toggle=
"wy-nav-shift" class=
"wy-nav-content-wrap">
125 <nav class=
"wy-nav-top" aria-label=
"top navigation">
127 <i data-toggle=
"wy-nav-top" class=
"fa fa-bars"></i>
128 <a href=
"../index.html">libmemcached
</a>
133 <div class=
"wy-nav-content">
135 <div class=
"rst-content">
153 <div role=
"navigation" aria-label=
"breadcrumbs navigation">
155 <ul class=
"wy-breadcrumbs">
157 <li><a href=
"../index.html">Docs
</a> »</li>
159 <li><a href=
"index.html">libmemcachedutil API
</a> »</li>
161 <li>Working with memcached pools
</li>
164 <li class=
"wy-breadcrumbs-aside">
175 <div role=
"main" class=
"document" itemscope=
"itemscope" itemtype=
"http://schema.org/Article">
176 <div itemprop=
"articleBody">
178 <div class=
"section" id=
"working-with-memcached-pools">
179 <h1>Working with memcached pools
<a class=
"headerlink" href=
"#working-with-memcached-pools" title=
"Permalink to this headline">¶
</a></h1>
180 <div class=
"section" id=
"synopsis">
181 <h2>SYNOPSIS
<a class=
"headerlink" href=
"#synopsis" title=
"Permalink to this headline">¶
</a></h2>
183 <dt>#include
<libmemcachedutil-
1.0/pool.h
></dt><dd><p>Compile and link with -lmemcachedutil -lmemcached
</p>
187 <dt id=
"_CPPv417memcached_pool_st">
188 <span id=
"_CPPv317memcached_pool_st"></span><span id=
"_CPPv217memcached_pool_st"></span><span id=
"memcached_pool_st"></span><em class=
"property">typedef
</em><em class=
"property">struct
</em> <a class=
"reference internal" href=
"#_CPPv417memcached_pool_st" title=
"memcached_pool_st">memcached_pool_st
</a> <code class=
"sig-name descname">memcached_pool_st
</code><a class=
"headerlink" href=
"#_CPPv417memcached_pool_st" title=
"Permalink to this definition">¶
</a><br /></dt>
191 <dl class=
"function">
192 <dt id=
"_CPPv414memcached_poolPKc6size_t">
193 <span id=
"_CPPv314memcached_poolPKc6size_t"></span><span id=
"_CPPv214memcached_poolPKc6size_t"></span><span id=
"memcached_pool__cCP.s"></span><a class=
"reference internal" href=
"#_CPPv417memcached_pool_st" title=
"memcached_pool_st">memcached_pool_st
</a> *
<code class=
"sig-name descname">memcached_pool
</code><span class=
"sig-paren">(
</span><em class=
"property">const
</em> char *
<em>option_string
</em>, size_t
<em>option_string_length
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv414memcached_poolPKc6size_t" title=
"Permalink to this definition">¶
</a><br /></dt>
196 <dl class=
"function">
197 <dt id=
"_CPPv422memcached_pool_destroyP17memcached_pool_st">
198 <span id=
"_CPPv322memcached_pool_destroyP17memcached_pool_st"></span><span id=
"_CPPv222memcached_pool_destroyP17memcached_pool_st"></span><span id=
"memcached_pool_destroy__memcached_pool_stP"></span><a class=
"reference internal" href=
"../libmemcached/memcached_create.html#_CPPv412memcached_st" title=
"memcached_st">memcached_st
</a> *
<code class=
"sig-name descname">memcached_pool_destroy
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"#_CPPv417memcached_pool_st" title=
"memcached_pool_st">memcached_pool_st
</a> *
<em>pool
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv422memcached_pool_destroyP17memcached_pool_st" title=
"Permalink to this definition">¶
</a><br /></dt>
201 <dl class=
"function">
202 <dt id=
"_CPPv420memcached_pool_fetchP17memcached_pool_stP8timespecP18memcached_return_t">
203 <span id=
"_CPPv320memcached_pool_fetchP17memcached_pool_stP8timespecP18memcached_return_t"></span><span id=
"_CPPv220memcached_pool_fetchP17memcached_pool_stP8timespecP18memcached_return_t"></span><span id=
"memcached_pool_fetch__memcached_pool_stP.timespecP.memcached_return_tP"></span><a class=
"reference internal" href=
"../libmemcached/memcached_create.html#_CPPv412memcached_st" title=
"memcached_st">memcached_st
</a> *
<code class=
"sig-name descname">memcached_pool_fetch
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"#_CPPv417memcached_pool_st" title=
"memcached_pool_st">memcached_pool_st
</a> *,
<em class=
"property">struct
</em> timespec *
<em>relative_time
</em>,
<a class=
"reference internal" href=
"../libmemcached/memcached_return_t.html#_CPPv418memcached_return_t" title=
"memcached_return_t">memcached_return_t
</a> *
<em>rc
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv420memcached_pool_fetchP17memcached_pool_stP8timespecP18memcached_return_t" title=
"Permalink to this definition">¶
</a><br /></dt>
204 <dd><div class=
"versionadded">
205 <p><span class=
"versionmodified added">New in version
0.53:
</span>Synonym for memcached_pool_pop
</p>
209 <dl class=
"function">
210 <dt id=
"_CPPv422memcached_pool_releaseP17memcached_pool_stP12memcached_st">
211 <span id=
"_CPPv322memcached_pool_releaseP17memcached_pool_stP12memcached_st"></span><span id=
"_CPPv222memcached_pool_releaseP17memcached_pool_stP12memcached_st"></span><span id=
"memcached_pool_release__memcached_pool_stP.memcached_stP"></span><a class=
"reference internal" href=
"../libmemcached/memcached_return_t.html#_CPPv418memcached_return_t" title=
"memcached_return_t">memcached_return_t
</a> <code class=
"sig-name descname">memcached_pool_release
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"#_CPPv417memcached_pool_st" title=
"memcached_pool_st">memcached_pool_st
</a> *
<em>pool
</em>,
<a class=
"reference internal" href=
"../libmemcached/memcached_create.html#_CPPv412memcached_st" title=
"memcached_st">memcached_st
</a> *
<em>mmc
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv422memcached_pool_releaseP17memcached_pool_stP12memcached_st" title=
"Permalink to this definition">¶
</a><br /></dt>
212 <dd><div class=
"versionadded">
213 <p><span class=
"versionmodified added">New in version
0.53:
</span>Synonym for memcached_pool_push.
</p>
217 <dl class=
"function">
218 <dt id=
"_CPPv427memcached_pool_behavior_setP17memcached_pool_st20memcached_behavior_t8uint64_t">
219 <span id=
"_CPPv327memcached_pool_behavior_setP17memcached_pool_st20memcached_behavior_t8uint64_t"></span><span id=
"_CPPv227memcached_pool_behavior_setP17memcached_pool_st20memcached_behavior_t8uint64_t"></span><span id=
"memcached_pool_behavior_set__memcached_pool_stP.memcached_behavior_t.uint64_t"></span><a class=
"reference internal" href=
"../libmemcached/memcached_return_t.html#_CPPv418memcached_return_t" title=
"memcached_return_t">memcached_return_t
</a> <code class=
"sig-name descname">memcached_pool_behavior_set
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"#_CPPv417memcached_pool_st" title=
"memcached_pool_st">memcached_pool_st
</a> *
<em>pool
</em>,
<a class=
"reference internal" href=
"../libmemcached/memcached_behavior.html#_CPPv420memcached_behavior_t" title=
"memcached_behavior_t">memcached_behavior_t
</a> <em>flag
</em>, uint64_t
<em>data
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv427memcached_pool_behavior_setP17memcached_pool_st20memcached_behavior_t8uint64_t" title=
"Permalink to this definition">¶
</a><br /></dt>
222 <dl class=
"function">
223 <dt id=
"_CPPv427memcached_pool_behavior_getP17memcached_pool_st20memcached_behavior_tP8uint64_t">
224 <span id=
"_CPPv327memcached_pool_behavior_getP17memcached_pool_st20memcached_behavior_tP8uint64_t"></span><span id=
"_CPPv227memcached_pool_behavior_getP17memcached_pool_st20memcached_behavior_tP8uint64_t"></span><span id=
"memcached_pool_behavior_get__memcached_pool_stP.memcached_behavior_t.uint64_tP"></span><a class=
"reference internal" href=
"../libmemcached/memcached_return_t.html#_CPPv418memcached_return_t" title=
"memcached_return_t">memcached_return_t
</a> <code class=
"sig-name descname">memcached_pool_behavior_get
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"#_CPPv417memcached_pool_st" title=
"memcached_pool_st">memcached_pool_st
</a> *
<em>pool
</em>,
<a class=
"reference internal" href=
"../libmemcached/memcached_behavior.html#_CPPv420memcached_behavior_t" title=
"memcached_behavior_t">memcached_behavior_t
</a> <em>flag
</em>, uint64_t *
<em>value
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv427memcached_pool_behavior_getP17memcached_pool_st20memcached_behavior_tP8uint64_t" title=
"Permalink to this definition">¶
</a><br /></dt>
227 <dl class=
"function">
228 <dt id=
"_CPPv421memcached_pool_createP12memcached_stii">
229 <span id=
"_CPPv321memcached_pool_createP12memcached_stii"></span><span id=
"_CPPv221memcached_pool_createP12memcached_stii"></span><span id=
"memcached_pool_create__memcached_stP.i.i"></span><a class=
"reference internal" href=
"#_CPPv417memcached_pool_st" title=
"memcached_pool_st">memcached_pool_st
</a> *
<code class=
"sig-name descname">memcached_pool_create
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"../libmemcached/memcached_create.html#_CPPv412memcached_st" title=
"memcached_st">memcached_st
</a> *
<em>mmc
</em>, int
<em>initial
</em>, int
<em>max
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv421memcached_pool_createP12memcached_stii" title=
"Permalink to this definition">¶
</a><br /></dt>
230 <dd><div class=
"deprecated">
231 <p><span class=
"versionmodified deprecated">Deprecated since version
0.46:
</span>Use
<a class=
"reference internal" href=
"#_CPPv414memcached_poolPKc6size_t" title=
"memcached_pool"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool()
</span></code></a></p>
235 <dl class=
"function">
236 <dt id=
"_CPPv418memcached_pool_popP17memcached_pool_stbP18memcached_return_t">
237 <span id=
"_CPPv318memcached_pool_popP17memcached_pool_stbP18memcached_return_t"></span><span id=
"_CPPv218memcached_pool_popP17memcached_pool_stbP18memcached_return_t"></span><span id=
"memcached_pool_pop__memcached_pool_stP.b.memcached_return_tP"></span><a class=
"reference internal" href=
"../libmemcached/memcached_create.html#_CPPv412memcached_st" title=
"memcached_st">memcached_st
</a> *
<code class=
"sig-name descname">memcached_pool_pop
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"#_CPPv417memcached_pool_st" title=
"memcached_pool_st">memcached_pool_st
</a> *
<em>pool
</em>, bool
<em>block
</em>,
<a class=
"reference internal" href=
"../libmemcached/memcached_return_t.html#_CPPv418memcached_return_t" title=
"memcached_return_t">memcached_return_t
</a> *
<em>rc
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv418memcached_pool_popP17memcached_pool_stbP18memcached_return_t" title=
"Permalink to this definition">¶
</a><br /></dt>
238 <dd><div class=
"deprecated">
239 <p><span class=
"versionmodified deprecated">Deprecated since version
0.53:
</span>Use
<a class=
"reference internal" href=
"#_CPPv420memcached_pool_fetchP17memcached_pool_stP8timespecP18memcached_return_t" title=
"memcached_pool_fetch"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool_fetch()
</span></code></a></p>
243 <dl class=
"function">
244 <dt id=
"_CPPv419memcached_pool_pushP17memcached_pool_stP12memcached_st">
245 <span id=
"_CPPv319memcached_pool_pushP17memcached_pool_stP12memcached_st"></span><span id=
"_CPPv219memcached_pool_pushP17memcached_pool_stP12memcached_st"></span><span id=
"memcached_pool_push__memcached_pool_stP.memcached_stP"></span><a class=
"reference internal" href=
"../libmemcached/memcached_return_t.html#_CPPv418memcached_return_t" title=
"memcached_return_t">memcached_return_t
</a> <code class=
"sig-name descname">memcached_pool_push
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"#_CPPv417memcached_pool_st" title=
"memcached_pool_st">memcached_pool_st
</a> *
<em>pool
</em>,
<a class=
"reference internal" href=
"../libmemcached/memcached_create.html#_CPPv412memcached_st" title=
"memcached_st">memcached_st
</a> *
<em>mmc
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv419memcached_pool_pushP17memcached_pool_stP12memcached_st" title=
"Permalink to this definition">¶
</a><br /></dt>
246 <dd><div class=
"deprecated">
247 <p><span class=
"versionmodified deprecated">Deprecated since version
0.53:
</span>Use
<a class=
"reference internal" href=
"#_CPPv422memcached_pool_releaseP17memcached_pool_stP12memcached_st" title=
"memcached_pool_release"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool_release()
</span></code></a></p>
252 <div class=
"section" id=
"description">
253 <h2>DESCRIPTION
<a class=
"headerlink" href=
"#description" title=
"Permalink to this headline">¶
</a></h2>
254 <p><a class=
"reference internal" href=
"#_CPPv414memcached_poolPKc6size_t" title=
"memcached_pool"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool()
</span></code></a> is used to create a connection pool of objects you may use to
255 remove the overhead of using memcached_clone for short lived
<a class=
"reference internal" href=
"../libmemcached/memcached_create.html#_CPPv412memcached_st" title=
"memcached_st"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_st
</span></code></a>
256 objects. Please see
<a class=
"reference internal" href=
"../libmemcached/configuration.html"><span class=
"doc">libmemcached Configuration
</span></a> for details on the
257 format of the configuration string.
</p>
258 <p><a class=
"reference internal" href=
"#_CPPv422memcached_pool_destroyP17memcached_pool_st" title=
"memcached_pool_destroy"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool_destroy()
</span></code></a> is used to destroy the connection pool created with
259 <a class=
"reference internal" href=
"#_CPPv421memcached_pool_createP12memcached_stii" title=
"memcached_pool_create"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool_create()
</span></code></a> and release all allocated resources. It will return the
260 pointer to the
<a class=
"reference internal" href=
"../libmemcached/memcached_create.html#_CPPv412memcached_st" title=
"memcached_st"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_st
</span></code></a> structure passed as an argument to
261 <a class=
"reference internal" href=
"#_CPPv421memcached_pool_createP12memcached_stii" title=
"memcached_pool_create"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool_create()
</span></code></a>, and returns the ownership of the pointer to the caller
262 when created with
<a class=
"reference internal" href=
"#_CPPv421memcached_pool_createP12memcached_stii" title=
"memcached_pool_create"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool_create()
</span></code></a>, otherwise NULL is returned..
</p>
263 <p><a class=
"reference internal" href=
"#_CPPv420memcached_pool_fetchP17memcached_pool_stP8timespecP18memcached_return_t" title=
"memcached_pool_fetch"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool_fetch()
</span></code></a> is used to fetch a connection structure from the
264 connection pool. The relative_time argument specifies if the function should
265 block and wait for a connection structure to be available if we try to exceed
266 the maximum size. You need to specify time in relative time.
</p>
267 <p><a class=
"reference internal" href=
"#_CPPv422memcached_pool_releaseP17memcached_pool_stP12memcached_st" title=
"memcached_pool_release"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool_release()
</span></code></a> is used to return a connection structure back to the
269 <p><a class=
"reference internal" href=
"#_CPPv427memcached_pool_behavior_getP17memcached_pool_st20memcached_behavior_tP8uint64_t" title=
"memcached_pool_behavior_get"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool_behavior_get()
</span></code></a> and
<a class=
"reference internal" href=
"#_CPPv427memcached_pool_behavior_setP17memcached_pool_st20memcached_behavior_t8uint64_t" title=
"memcached_pool_behavior_set"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool_behavior_set()
</span></code></a> is used to
270 get/set behavior flags on all connections in the pool.
</p>
271 <p>Both
<a class=
"reference internal" href=
"#_CPPv422memcached_pool_releaseP17memcached_pool_stP12memcached_st" title=
"memcached_pool_release"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool_release()
</span></code></a> and
<a class=
"reference internal" href=
"#_CPPv420memcached_pool_fetchP17memcached_pool_stP8timespecP18memcached_return_t" title=
"memcached_pool_fetch"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool_fetch()
</span></code></a> are thread safe.
</p>
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=
"#_CPPv422memcached_pool_destroyP17memcached_pool_st" title=
"memcached_pool_destroy"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool_destroy()
</span></code></a> returns the pointer (and ownership) to the
276 <a class=
"reference internal" href=
"../libmemcached/memcached_create.html#_CPPv412memcached_st" title=
"memcached_st"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_st
</span></code></a> structure used to create the pool. If connections are in use it
278 <p><a class=
"reference internal" href=
"#_CPPv418memcached_pool_popP17memcached_pool_stbP18memcached_return_t" title=
"memcached_pool_pop"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool_pop()
</span></code></a> returns a pointer to a
<a class=
"reference internal" href=
"../libmemcached/memcached_create.html#_CPPv412memcached_st" title=
"memcached_st"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_st
</span></code></a> structure from the
279 pool (or NULL if an allocation cannot be satisfied).
</p>
280 <p><a class=
"reference internal" href=
"#_CPPv422memcached_pool_releaseP17memcached_pool_stP12memcached_st" title=
"memcached_pool_release"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool_release()
</span></code></a> returns
<a class=
"reference internal" href=
"../libmemcached/memcached_return_t.html#_CPPv4N18memcached_return_t17MEMCACHED_SUCCESSE" title=
"MEMCACHED_SUCCESS"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">MEMCACHED_SUCCESS
</span></code></a> upon success.
</p>
281 <p><a class=
"reference internal" href=
"#_CPPv427memcached_pool_behavior_getP17memcached_pool_st20memcached_behavior_tP8uint64_t" title=
"memcached_pool_behavior_get"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool_behavior_get()
</span></code></a> and
<a class=
"reference internal" href=
"#_CPPv427memcached_pool_behavior_getP17memcached_pool_st20memcached_behavior_tP8uint64_t" title=
"memcached_pool_behavior_get"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">memcached_pool_behavior_get()
</span></code></a> returns
282 <a class=
"reference internal" href=
"../libmemcached/memcached_return_t.html#_CPPv4N18memcached_return_t17MEMCACHED_SUCCESSE" title=
"MEMCACHED_SUCCESS"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">MEMCACHED_SUCCESS
</span></code></a> upon success.
</p>
283 <p>If any methods returns MEMCACHED_IN_PROGRESS then a lock on the pool could not
284 be obtained. If any of the parameters passed to any of these functions is
285 invalid, MEMCACHED_INVALID_ARGUMENTS will be returned.
</p>
286 <p>memcached_pool_fetch may return MEMCACHED_TIMEOUT if a timeout occurs while
287 waiting for a free memcached_st. MEMCACHED_NOTFOUND if no memcached_st was
290 <div class=
"section" id=
"see-also">
291 <h2>SEE ALSO
<a class=
"headerlink" href=
"#see-also" title=
"Permalink to this headline">¶
</a></h2>
293 <li><p><em class=
"manpage"><a class=
"manpage reference external" href=
"http://man7.org/linux/man-pages/man1/memcached.1.html">memcached(
1)
</a></em></p></li>
294 <li><p><a class=
"reference internal" href=
"../libmemcached.html"><span class=
"doc">C/C++ Client Library for memcached
</span></a></p></li>
295 <li><p><a class=
"reference internal" href=
"../libmemcached/configuration.html"><span class=
"doc">libmemcached Configuration
</span></a></p></li>
296 <li><p><a class=
"reference internal" href=
"../libmemcached/memcached_strerror.html"><span class=
"doc">Converting Error Codes to Messages
</span></a></p></li>
307 <div class=
"rst-footer-buttons" role=
"navigation" aria-label=
"footer navigation">
309 <a href=
"../libhashkit.html" class=
"btn btn-neutral float-right" title=
"libhashkit - C/C++ hashing library" accesskey=
"n" rel=
"next">Next
<span class=
"fa fa-arrow-circle-right"></span></a>
312 <a href=
"index.html" class=
"btn btn-neutral float-left" title=
"libmemcachedutil API" accesskey=
"p" rel=
"prev"><span class=
"fa fa-arrow-circle-left"></span> Previous
</a>
319 <div role=
"contentinfo">
321 © <a href=
"../copyright.html">Copyright
</a>
325 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>.
338 <script type=
"text/javascript">
340 SphinxRtdTheme.Navigation.enable(true);