<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Setting callbacks — libmemcached 1.0.99 documentation</title>
+ <title>Library callbacks — libmemcached 1.0.99 documentation</title>
<li class="toctree-l2 current"><a class="reference internal" href="index_advanced.html">Advanced Topics</a><ul class="current">
<li class="toctree-l3 current"><a class="reference internal" href="index_advanced_internals.html">Internal Behavior</a><ul class="current">
<li class="toctree-l4"><a class="reference internal" href="memcached_behavior.html">Behaviors of the library</a></li>
-<li class="toctree-l4 current"><a class="current reference internal" href="#">Setting callbacks</a></li>
+<li class="toctree-l4 current"><a class="current reference internal" href="#">Library callbacks</a></li>
<li class="toctree-l4"><a class="reference internal" href="memcached_memory_allocators.html">Use custom allocators for embedded usage</a></li>
<li class="toctree-l4"><a class="reference internal" href="memcached_user_data.html">Storing custom user information in the client.</a></li>
</ul>
<li><a href="index_advanced_internals.html">Internal Behavior</a> »</li>
- <li>Setting callbacks</li>
+ <li>Library callbacks</li>
<li class="wy-breadcrumbs-aside">
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
- <div class="section" id="setting-callbacks">
-<h1>Setting callbacks<a class="headerlink" href="#setting-callbacks" title="Permalink to this headline">¶</a></h1>
-<p>Get and set a callback</p>
+ <div class="section" id="library-callbacks">
+<h1>Library callbacks<a class="headerlink" href="#library-callbacks" title="Permalink to this headline">¶</a></h1>
<div class="section" id="synopsis">
-<
span id="index-0"></span><h2>SYNOPSIS<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
+<h2>SYNOPSIS<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
<dl class="simple">
<dt>#include <libmemcached/memcached.h></dt><dd><p>Compile and link with -lmemcached</p>
</dd>
<dd></dd></dl>
<dl class="type">
-<dt id="c.memcached_callback_t">
-enum <a class="reference internal" href="#c.memcached_callback_t" title="memcached_callback_t">memcached_callback_t</a> <code class="sig-name descname">memcached_callback_t</code><a class="headerlink" href="#c.memcached_callback_t" title="Permalink to this definition">¶</a></dt>
+<dt id="_CPPv420memcached_callback_t">
+<span id="_CPPv320memcached_callback_t"></span><span id="_CPPv220memcached_callback_t"></span><span id="memcached_callback_t"></span><em class="property">typedef </em><em class="property">enum</em> <a class="reference internal" href="#_CPPv420memcached_callback_t" title="memcached_callback_t">memcached_callback_t</a> <code class="sig-name descname">memcached_callback_t</code><a class="headerlink" href="#_CPPv420memcached_callback_t" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>
<dl class="enum">
<dt id="_CPPv420memcached_callback_t">
-<span id="_CPPv320memcached_callback_t"></span><span id="_CPPv220memcached_callback_t"></span><em class="property">enum </em><code class="sig-name descname">memcached_callback_t</code><a class="headerlink" href="#_CPPv420memcached_callback_t" title="Permalink to this definition">¶</a><br /></dt>
+<span id="_CPPv320memcached_callback_t"></span><span id="_CPPv220memcached_callback_t"></span><em class="property">enum </em><code class="sig-name descname">memcached_callback_t</code><br /></dt>
<dd><dl class="enumerator">
<dt id="_CPPv4N20memcached_callback_t35MEMCACHED_CALLBACK_CLEANUP_FUNCTIONE">
<span id="_CPPv3N20memcached_callback_t35MEMCACHED_CALLBACK_CLEANUP_FUNCTIONE"></span><span id="_CPPv2N20memcached_callback_t35MEMCACHED_CALLBACK_CLEANUP_FUNCTIONE"></span><em class="property">enumerator </em><code class="sig-name descname">MEMCACHED_CALLBACK_CLEANUP_FUNCTION</code><a class="headerlink" href="#_CPPv4N20memcached_callback_t35MEMCACHED_CALLBACK_CLEANUP_FUNCTIONE" title="Permalink to this definition">¶</a><br /></dt>
-<dd><p>When <a class="reference internal" href="memcached_delete.html#_CPPv416memcached_deleteP12memcached_stPKc6size_t6time_t" title="memcached_delete"><code class="xref cpp cpp-func docutils literal notranslate"><span class="pre">memcached_delete()</span></code></a> is called this function will be executed. At
-the point of its execution all connections are closed.</p>
+<dd><p>When <a class="reference internal" href="memcached_delete.html#_CPPv416memcached_deleteP12memcached_stPKc6size_t6time_t" title="memcached_delete"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">memcached_delete()</span></code></a> is called this function will be executed. At the
+point of its execution all connections are closed.</p>
</dd></dl>
<dl class="enumerator">
<dt id="_CPPv4N20memcached_callback_t33MEMCACHED_CALLBACK_CLONE_FUNCTIONE">
<span id="_CPPv3N20memcached_callback_t33MEMCACHED_CALLBACK_CLONE_FUNCTIONE"></span><span id="_CPPv2N20memcached_callback_t33MEMCACHED_CALLBACK_CLONE_FUNCTIONE"></span><em class="property">enumerator </em><code class="sig-name descname">MEMCACHED_CALLBACK_CLONE_FUNCTION</code><a class="headerlink" href="#_CPPv4N20memcached_callback_t33MEMCACHED_CALLBACK_CLONE_FUNCTIONE" title="Permalink to this definition">¶</a><br /></dt>
-<dd><p>When <a class="reference internal" href="memcached_delete.html#_CPPv416memcached_deleteP12memcached_stPKc6size_t6time_t" title="memcached_delete"><code class="xref cpp cpp-func docutils literal notranslate"><span class="pre">memcached_delete()</span></code></a> is called this function will be executed.
-At the point of its execution all connections are closed.</p>
+<dd><p>When <a class="reference internal" href="memcached_delete.html#_CPPv416memcached_deleteP12memcached_stPKc6size_t6time_t" title="memcached_delete"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">memcached_delete()</span></code></a> is called this function will be executed. At the
+point of its execution all connections are closed.</p>
</dd></dl>
<dl class="enumerator">
<dt id="_CPPv4N20memcached_callback_t28MEMCACHED_CALLBACK_NAMESPACEE">
<span id="_CPPv3N20memcached_callback_t28MEMCACHED_CALLBACK_NAMESPACEE"></span><span id="_CPPv2N20memcached_callback_t28MEMCACHED_CALLBACK_NAMESPACEE"></span><em class="property">enumerator </em><code class="sig-name descname">MEMCACHED_CALLBACK_NAMESPACE</code><a class="headerlink" href="#_CPPv4N20memcached_callback_t28MEMCACHED_CALLBACK_NAMESPACEE" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>You can set a value which will be used to create a domain for your keys.
-The value specified here will be prefixed to each of your keys. The value can
-not be greater then <code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">MEMCACHED_PREFIX_KEY_MAX_SIZE</span></code> - 1 and will
-reduce <code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">MEMCACHED_MAX_KEY</span></code> by the value of your key.</p>
+The value specified here will be prefixed to each of your keys. The
+value can not be greater then <a class="reference internal" href="constants.html#c.MEMCACHED_MAX_NAMESPACE" title="MEMCACHED_MAX_NAMESPACE"><code class="xref c c-macro docutils literal notranslate"><span class="pre">MEMCACHED_MAX_NAMESPACE</span></code></a> - 1 and
+will reduce <a class="reference internal" href="constants.html#c.MEMCACHED_MAX_KEY" title="MEMCACHED_MAX_KEY"><code class="xref c c-macro docutils literal notranslate"><span class="pre">MEMCACHED_MAX_KEY</span></code></a> by the value of your key.</p>
<p>The prefix key is only applied to the primary key, not the master key.
-<a class="reference internal" href="memcached_return_t.html#_CPPv4N18memcached_return_t17MEMCACHED_FAILUREE" title="MEMCACHED_FAILURE"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">MEMCACHED_FAILURE</span></code></a> will be returned if no key is set. In the case of
-a key which is too long, <a class="reference internal" href="memcached_return_t.html#_CPPv4N18memcached_return_t26MEMCACHED_BAD_KEY_PROVIDEDE" title="MEMCACHED_BAD_KEY_PROVIDED"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">MEMCACHED_BAD_KEY_PROVIDED</span></code></a> will be returned.</p>
-<p>If you set a value with the value being NULL then the prefix key is disabled.</p>
+<a class="reference internal" href="memcached_return_t.html#_CPPv4N18memcached_return_t17MEMCACHED_FAILUREE" title="MEMCACHED_FAILURE"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">MEMCACHED_FAILURE</span></code></a> will be returned if no key is set. In the case of a
+key which is too long, <a class="reference internal" href="memcached_return_t.html#_CPPv4N18memcached_return_t26MEMCACHED_BAD_KEY_PROVIDEDE" title="MEMCACHED_BAD_KEY_PROVIDED"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">MEMCACHED_BAD_KEY_PROVIDED</span></code></a> will be returned.</p>
+<p>If you set a value with the value being NULL then the prefix key is
+disabled.</p>
</dd></dl>
<dl class="enumerator">
<dt id="_CPPv4N20memcached_callback_t28MEMCACHED_CALLBACK_USER_DATAE">
<span id="_CPPv3N20memcached_callback_t28MEMCACHED_CALLBACK_USER_DATAE"></span><span id="_CPPv2N20memcached_callback_t28MEMCACHED_CALLBACK_USER_DATAE"></span><em class="property">enumerator </em><code class="sig-name descname">MEMCACHED_CALLBACK_USER_DATA</code><a class="headerlink" href="#_CPPv4N20memcached_callback_t28MEMCACHED_CALLBACK_USER_DATAE" title="Permalink to this definition">¶</a><br /></dt>
-<dd><p>This allows you to store a pointer to a specific piece of data. This can be
-retrieved from inside of <a class="reference internal" href="memcached_get.html#_CPPv423memcached_fetch_executeP12memcached_stP20memcached_execute_fnPv8uint32_t" title="memcached_fetch_execute"><code class="xref cpp cpp-func docutils literal notranslate"><span class="pre">memcached_fetch_execute()</span></code></a>. Cloning a
-<a class="reference internal" href="memcached_create.html#_CPPv412memcached_st" title="memcached_st"><code class="xref cpp cpp-type docutils literal notranslate"><span class="pre">memcached_st</span></code></a> will copy the pointer to the clone.</p>
+<dd><p>This allows you to store a pointer to a specific piece of data. This can
+be retrieved from inside of <a class="reference internal" href="memcached_get.html#_CPPv423memcached_fetch_executeP12memcached_stP20memcached_execute_fnPv8uint32_t" title="memcached_fetch_execute"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">memcached_fetch_execute()</span></code></a>. Cloning a
+<a class="reference internal" href="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> will copy the pointer to the clone.</p>
</dd></dl>
<dl class="enumerator">
<dt id="_CPPv4N20memcached_callback_t34MEMCACHED_CALLBACK_MALLOC_FUNCTIONE">
<span id="_CPPv3N20memcached_callback_t34MEMCACHED_CALLBACK_MALLOC_FUNCTIONE"></span><span id="_CPPv2N20memcached_callback_t34MEMCACHED_CALLBACK_MALLOC_FUNCTIONE"></span><em class="property">enumerator </em><code class="sig-name descname">MEMCACHED_CALLBACK_MALLOC_FUNCTION</code><a class="headerlink" href="#_CPPv4N20memcached_callback_t34MEMCACHED_CALLBACK_MALLOC_FUNCTIONE" title="Permalink to this definition">¶</a><br /></dt>
<dd><div class="deprecated">
-<p><span class="versionmodified deprecated">Deprecated since version <0.32: </span>Use <a class="reference internal" href="memcached_memory_allocators.html#_CPPv431memcached_set_memory_allocatorsP12memcached_st19memcached_malloc_fn17memcached_free_fn20memcached_realloc_fn19memcached_calloc_fnPv" title="memcached_set_memory_allocators"><code class="xref cpp cpp-type docutils literal notranslate"><span class="pre">memcached_set_memory_allocators</span></code></a> instead.</p>
+<p><span class="versionmodified deprecated">Deprecated since version <0.32: </span>Use <a class="reference internal" href="memcached_memory_allocators.html#_CPPv431memcached_set_memory_allocatorsP12memcached_st19memcached_malloc_fn17memcached_free_fn20memcached_realloc_fn19memcached_calloc_fnPv" title="memcached_set_memory_allocators"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">memcached_set_memory_allocators()</span></code></a> instead.</p>
</div>
</dd></dl>
<dt id="_CPPv4N20memcached_callback_t35MEMCACHED_CALLBACK_REALLOC_FUNCTIONE">
<span id="_CPPv3N20memcached_callback_t35MEMCACHED_CALLBACK_REALLOC_FUNCTIONE"></span><span id="_CPPv2N20memcached_callback_t35MEMCACHED_CALLBACK_REALLOC_FUNCTIONE"></span><em class="property">enumerator </em><code class="sig-name descname">MEMCACHED_CALLBACK_REALLOC_FUNCTION</code><a class="headerlink" href="#_CPPv4N20memcached_callback_t35MEMCACHED_CALLBACK_REALLOC_FUNCTIONE" title="Permalink to this definition">¶</a><br /></dt>
<dd><div class="deprecated">
-<p><span class="versionmodified deprecated">Deprecated since version <0.32: </span>Use <a class="reference internal" href="memcached_memory_allocators.html#_CPPv431memcached_set_memory_allocatorsP12memcached_st19memcached_malloc_fn17memcached_free_fn20memcached_realloc_fn19memcached_calloc_fnPv" title="memcached_set_memory_allocators"><code class="xref cpp cpp-type docutils literal notranslate"><span class="pre">memcached_set_memory_allocators</span></code></a> instead.</p>
+<p><span class="versionmodified deprecated">Deprecated since version <0.32: </span>Use <a class="reference internal" href="memcached_memory_allocators.html#_CPPv431memcached_set_memory_allocatorsP12memcached_st19memcached_malloc_fn17memcached_free_fn20memcached_realloc_fn19memcached_calloc_fnPv" title="memcached_set_memory_allocators"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">memcached_set_memory_allocators()</span></code></a> instead.</p>
</div>
</dd></dl>
<dt id="_CPPv4N20memcached_callback_t32MEMCACHED_CALLBACK_FREE_FUNCTIONE">
<span id="_CPPv3N20memcached_callback_t32MEMCACHED_CALLBACK_FREE_FUNCTIONE"></span><span id="_CPPv2N20memcached_callback_t32MEMCACHED_CALLBACK_FREE_FUNCTIONE"></span><em class="property">enumerator </em><code class="sig-name descname">MEMCACHED_CALLBACK_FREE_FUNCTION</code><a class="headerlink" href="#_CPPv4N20memcached_callback_t32MEMCACHED_CALLBACK_FREE_FUNCTIONE" title="Permalink to this definition">¶</a><br /></dt>
<dd><div class="deprecated">
-<p><span class="versionmodified deprecated">Deprecated since version <0.32: </span>Use <a class="reference internal" href="memcached_memory_allocators.html#_CPPv431memcached_set_memory_allocatorsP12memcached_st19memcached_malloc_fn17memcached_free_fn20memcached_realloc_fn19memcached_calloc_fnPv" title="memcached_set_memory_allocators"><code class="xref cpp cpp-type docutils literal notranslate"><span class="pre">memcached_set_memory_allocators</span></code></a> instead.</p>
+<p><span class="versionmodified deprecated">Deprecated since version <0.32: </span>Use <a class="reference internal" href="memcached_memory_allocators.html#_CPPv431memcached_set_memory_allocatorsP12memcached_st19memcached_malloc_fn17memcached_free_fn20memcached_realloc_fn19memcached_calloc_fnPv" title="memcached_set_memory_allocators"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">memcached_set_memory_allocators()</span></code></a> instead.</p>
</div>
</dd></dl>
<dl class="enumerator">
<dt id="_CPPv4N20memcached_callback_t30MEMCACHED_CALLBACK_GET_FAILUREE">
<span id="_CPPv3N20memcached_callback_t30MEMCACHED_CALLBACK_GET_FAILUREE"></span><span id="_CPPv2N20memcached_callback_t30MEMCACHED_CALLBACK_GET_FAILUREE"></span><em class="property">enumerator </em><code class="sig-name descname">MEMCACHED_CALLBACK_GET_FAILURE</code><a class="headerlink" href="#_CPPv4N20memcached_callback_t30MEMCACHED_CALLBACK_GET_FAILUREE" title="Permalink to this definition">¶</a><br /></dt>
-<dd><p>This function implements the read through cache behavior. On failure of retrieval this callback will be called.</p>
-<p>You are responsible for populating the result object provided. This result object will then be stored in the server and returned to the calling process.</p>
-<p>You must clone the <a class="reference internal" href="memcached_create.html#_CPPv412memcached_st" title="memcached_st"><code class="xref cpp cpp-type docutils literal notranslate"><span class="pre">memcached_st</span></code></a> in order to
-make use of it. The value will be stored only if you return
-<a class="reference internal" href="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> or <a class="reference internal" href="memcached_return_t.html#_CPPv4N18memcached_return_t18MEMCACHED_BUFFEREDE" title="MEMCACHED_BUFFERED"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">MEMCACHED_BUFFERED</span></code></a>. Returning
-<a class="reference internal" href="memcached_return_t.html#_CPPv4N18memcached_return_t18MEMCACHED_BUFFEREDE" title="MEMCACHED_BUFFERED"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">MEMCACHED_BUFFERED</span></code></a> will cause the object to be buffered and not sent
-immediately (if this is the default behavior based on your connection setup
-this will happen automatically).</p>
+<dd><p>This function implements the read through cache behavior. On failure of
+retrieval this callback will be called.</p>
+<p>You are responsible for populating the result object provided. This
+result object will then be stored in the server and returned to the
+calling process.</p>
+<p>You must clone the <a class="reference internal" href="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> in order to make use of it. The value
+will be stored only if you return <a class="reference internal" href="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> or
+<a class="reference internal" href="memcached_return_t.html#_CPPv4N18memcached_return_t18MEMCACHED_BUFFEREDE" title="MEMCACHED_BUFFERED"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">MEMCACHED_BUFFERED</span></code></a>. Returning <a class="reference internal" href="memcached_return_t.html#_CPPv4N18memcached_return_t18MEMCACHED_BUFFEREDE" title="MEMCACHED_BUFFERED"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">MEMCACHED_BUFFERED</span></code></a> will cause the
+object to be buffered and not sent immediately (if this is the default
+behavior based on your connection setup this will happen automatically).</p>
<p>The prototype for this is:</p>
<dl class="type">
<dt id="_CPPv4N20memcached_callback_t30MEMCACHED_CALLBACK_GET_FAILURE21memcached_trigger_keyE">
<dl class="enumerator">
<dt id="_CPPv4N20memcached_callback_t33MEMCACHED_CALLBACK_DELETE_TRIGGERE">
<span id="_CPPv3N20memcached_callback_t33MEMCACHED_CALLBACK_DELETE_TRIGGERE"></span><span id="_CPPv2N20memcached_callback_t33MEMCACHED_CALLBACK_DELETE_TRIGGERE"></span><em class="property">enumerator </em><code class="sig-name descname">MEMCACHED_CALLBACK_DELETE_TRIGGER</code><a class="headerlink" href="#_CPPv4N20memcached_callback_t33MEMCACHED_CALLBACK_DELETE_TRIGGERE" title="Permalink to this definition">¶</a><br /></dt>
-<dd><p>This function implements a trigger upon successful deletion of a key. The memcached_st structure will need to be cloned in order to make use of it.</p>
+<dd><p>This function implements a trigger upon successful deletion of a key.
+The <a class="reference internal" href="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 will need to be cloned in order to make use
+of it.</p>
<p>The prototype for this is:</p>
<dl class="type">
<dt id="_CPPv4N20memcached_callback_t33MEMCACHED_CALLBACK_DELETE_TRIGGER28memcached_trigger_delete_keyE">
</div>
<div class="section" id="description">
<h2>DESCRIPTION<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
-<p><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">libmemcached</span></code> can have callbacks set key execution points. These either
-provide function calls at points in the code, or return pointers to
-structures for particular usages.</p>
-<p><a class="reference internal" href="#_CPPv422memcached_callback_getP12memcached_st20memcached_callback_tP18memcached_return_t" title="memcached_callback_get"><code class="xref cpp cpp-func docutils literal notranslate"><span class="pre">memcached_callback_get()</span></code></a> takes a callback flag and returns the
-structure or function set by <a class="reference internal" href="#_CPPv422memcached_callback_setP12memcached_st20memcached_callback_tPKv" title="memcached_callback_set"><code class="xref cpp cpp-func docutils literal notranslate"><span class="pre">memcached_callback_set()</span></code></a>.</p>
-<p><a class="reference internal" href="#_CPPv422memcached_callback_setP12memcached_st20memcached_callback_tPKv" title="memcached_callback_set"><code class="xref cpp cpp-func docutils literal notranslate"><span class="pre">memcached_callback_set()</span></code></a> changes the function/structure assigned by a
-callback flag. No connections are reset.</p>
-<p>You can use <a class="reference internal" href="#_CPPv4N20memcached_callback_t28MEMCACHED_CALLBACK_USER_DATAE" title="MEMCACHED_CALLBACK_USER_DATA"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">MEMCACHED_CALLBACK_USER_DATA</span></code></a> to provide custom context
-if required for any of the callbacks.</p>
+<p><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">libmemcached</span></code> can have callbacks set key execution points. These either provide
+function calls at points in the code, or return pointers to structures for
+particular usages.</p>
+<p><a class="reference internal" href="#_CPPv422memcached_callback_getP12memcached_st20memcached_callback_tP18memcached_return_t" title="memcached_callback_get"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">memcached_callback_get()</span></code></a> takes a callback flag and returns the structure or
+function set by <a class="reference internal" href="#_CPPv422memcached_callback_setP12memcached_st20memcached_callback_tPKv" title="memcached_callback_set"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">memcached_callback_set()</span></code></a>.</p>
+<p><a class="reference internal" href="#_CPPv422memcached_callback_setP12memcached_st20memcached_callback_tPKv" title="memcached_callback_set"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">memcached_callback_set()</span></code></a> changes the function/structure assigned by a callback
+flag. No connections are reset.</p>
+<p>You can use <code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">MEMCACHED_CALLBACK_USER_DATA</span></code> to provide custom context if required
+for any of the callbacks.</p>
</div>
<div class="section" id="return-value">
<h2>RETURN VALUE<a class="headerlink" href="#return-value" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="#_CPPv422memcached_callback_getP12memcached_st20memcached_callback_tP18memcached_return_t" title="memcached_callback_get"><code class="xref cpp cpp-func docutils literal notranslate"><span class="pre">memcached_callback_get()</span></code></a> return the function or structure that was
-provided. Upon error, nothing is set, null is returned, and the
-
<a class="reference internal" href="memcached_return_t.html#_CPPv418memcached_return_t" title="memcached_return_t"><code class="xref cpp cpp-type docutils literal notranslate"><span class="pre">memcached_return_t</span></code></a> argument is set to <a class="reference internal" href="memcached_return_t.html#_CPPv4N18memcached_return_t17MEMCACHED_FAILUREE" title="MEMCACHED_FAILURE"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">MEMCACHED_FAILURE</span></code></a>.</p>
-<p><a class="reference internal" href="#_CPPv422memcached_callback_setP12memcached_st20memcached_callback_tPKv" title="memcached_callback_set"><code class="xref cpp cpp-func docutils literal notranslate"><span class="pre">memcached_callback_set()</span></code></a> returns <a class="reference internal" href="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
-
successful setting, otherwise <a class="reference internal" href="memcached_return_t.html#_CPPv4N18memcached_return_t17MEMCACHED_FAILUREE" title="MEMCACHED_FAILURE"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">MEMCACHED_FAILURE</span></code></a> on error.</p>
+<p><a class="reference internal" href="#_CPPv422memcached_callback_getP12memcached_st20memcached_callback_tP18memcached_return_t" title="memcached_callback_get"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">memcached_callback_get()</span></code></a> returns the function or structure that was provided.
+Upon error, nothing is set, NULL is returned, and the <a class="reference internal" href="memcached_return_t.html#_CPPv418memcached_return_t" title="memcached_return_t"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">memcached_return_t</span></code></a>
+argument is set to <a class="reference internal" href="memcached_return_t.html#_CPPv4N18memcached_return_t17MEMCACHED_FAILUREE" title="MEMCACHED_FAILURE"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">MEMCACHED_FAILURE</span></code></a>.</p>
+<p><a class="reference internal" href="#_CPPv422memcached_callback_setP12memcached_st20memcached_callback_tPKv" title="memcached_callback_set"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">memcached_callback_set()</span></code></a> returns <a class="reference internal" href="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 successful setting,
+otherwise <a class="reference internal" href="memcached_return_t.html#_CPPv4N18memcached_return_t17MEMCACHED_FAILUREE" title="MEMCACHED_FAILURE"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">MEMCACHED_FAILURE</span></code></a> on error.</p>
</div>
<div class="section" id="see-also">
<h2>SEE ALSO<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
+<ul class="simple">
+<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>
+<li><p><a class="reference internal" href="../libmemcached.html"><span class="doc">C/C++ Client Library for memcached</span></a></p></li>
+<li><p><a class="reference internal" href="memcached_strerror.html"><span class="doc">Converting Error Codes to Messages</span></a></p></li>
+</ul>
</div>
</div>
projects / awesomized / libmemcached / blobdiff