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 result sets
— 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=
"Appending or Prepending to data on the server" href=
"memcached_append.html" />
40 <link rel=
"prev" title=
"Flushing client buffers" href=
"memcached_flush_buffers.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 current"><a class=
"reference internal" href=
"index.html">libmemcached API
</a><ul class=
"current">
92 <li class=
"toctree-l2"><a class=
"reference internal" href=
"index_basics.html">Basics
</a></li>
93 <li class=
"toctree-l2 current"><a class=
"reference internal" href=
"index_data.html">Working with Data
</a></li>
94 <li class=
"toctree-l2"><a class=
"reference internal" href=
"index_errors.html">Messages and Errors
</a></li>
95 <li class=
"toctree-l2"><a class=
"reference internal" href=
"index_advanced.html">Advanced Topics
</a></li>
96 <li class=
"toctree-l2"><a class=
"reference internal" href=
"index_deprecated.html">Deprecated Functionality
</a></li>
99 <li class=
"toctree-l1"><a class=
"reference internal" href=
"index_misc.html">Misc
</a><ul>
100 <li class=
"toctree-l2"><a class=
"reference internal" href=
"configuration.html">Configuration
</a></li>
101 <li class=
"toctree-l2"><a class=
"reference internal" href=
"constants.html">Constants
</a></li>
102 <li class=
"toctree-l2"><a class=
"reference internal" href=
"examples.html">Examples
</a></li>
103 <li class=
"toctree-l2"><a class=
"reference internal" href=
"versioning.html">Versioning
</a></li>
107 <p class=
"caption"><span class=
"caption-text">libmemcachedutil
</span></p>
109 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcachedutil.html">Introduction
</a></li>
110 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcachedutil/index.html">libmemcachedutil API
</a><ul>
111 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../libmemcachedutil/memcached_pool.html">Working with memcached pools
</a></li>
115 <p class=
"caption"><span class=
"caption-text">libhashkit
</span></p>
117 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libhashkit.html">Introduction
</a></li>
118 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libhashkit/index.html">libhashkit API
</a><ul>
119 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../libhashkit/hashkit_create.html">Creating a hashkit structure
</a></li>
120 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../libhashkit/hashkit_function.html">Set Hash Function
</a></li>
121 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../libhashkit/hashkit_functions.html">Available Hashes
</a></li>
122 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../libhashkit/hashkit_value.html">Generate hash value
</a></li>
126 <p class=
"caption"><span class=
"caption-text">Client Applications
</span></p>
128 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../bin/index.html">Client Applications
</a><ul>
129 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../bin/memcapable.html">memcapable - Checking a Memcached server capabilities and compatibility
</a></li>
130 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../bin/memcat.html">memcat - “cat” data from a server
</a></li>
131 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../bin/memcp.html">memcp - Copy data to a server
</a></li>
132 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../bin/memdump.html">memdump - Dumping your server
</a></li>
133 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../bin/memerror.html">memerror - translate an error code to a string
</a></li>
134 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../bin/memflush.html">memflush - flush all data from a server
</a></li>
135 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../bin/memrm.html">memrm - Remove data from a server
</a></li>
136 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../bin/memslap.html">memslap - Load testing and benchmarking a server
</a></li>
137 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../bin/memaslap.html">memaslap - Load testing and benchmarking a server
</a></li>
138 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../bin/memstat.html">memstat - Gather statistics from a server
</a></li>
139 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../bin/memexist.html">memexist - Check for the existence of a key
</a></li>
140 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../bin/memparse.html">memparse - Parse an option string
</a></li>
141 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../bin/memping.html">memping - Test to see if a server is available.
</a></li>
142 <li class=
"toctree-l2"><a class=
"reference internal" href=
"../bin/memtouch.html">memtouch - Touches a key.
</a></li>
153 <section data-toggle=
"wy-nav-shift" class=
"wy-nav-content-wrap">
156 <nav class=
"wy-nav-top" aria-label=
"top navigation">
158 <i data-toggle=
"wy-nav-top" class=
"fa fa-bars"></i>
159 <a href=
"../index.html">libmemcached
</a>
164 <div class=
"wy-nav-content">
166 <div class=
"rst-content">
184 <div role=
"navigation" aria-label=
"breadcrumbs navigation">
186 <ul class=
"wy-breadcrumbs">
188 <li><a href=
"../index.html">Docs
</a> »</li>
190 <li><a href=
"index.html">libmemcached API
</a> »</li>
192 <li><a href=
"index_data.html">Working with Data
</a> »</li>
194 <li>Working with result sets
</li>
197 <li class=
"wy-breadcrumbs-aside">
208 <div role=
"main" class=
"document" itemscope=
"itemscope" itemtype=
"http://schema.org/Article">
209 <div itemprop=
"articleBody">
211 <div class=
"section" id=
"working-with-result-sets">
212 <h1>Working with result sets
<a class=
"headerlink" href=
"#working-with-result-sets" title=
"Permalink to this headline">¶
</a></h1>
213 <div class=
"section" id=
"synopsis">
214 <h2>SYNOPSIS
<a class=
"headerlink" href=
"#synopsis" title=
"Permalink to this headline">¶
</a></h2>
215 <p>#include
<libmemcached/memcached_pool.h
></p>
217 <dt id=
"_CPPv419memcached_result_st">
218 <span id=
"_CPPv319memcached_result_st"></span><span id=
"_CPPv219memcached_result_st"></span><span id=
"memcached_result_st"></span><em class=
"property">type
</em><code class=
"sig-name descname">memcached_result_st
</code><a class=
"headerlink" href=
"#_CPPv419memcached_result_st" title=
"Permalink to this definition">¶
</a><br /></dt>
221 <dl class=
"function">
222 <dt id=
"_CPPv423memcached_result_createP12memcached_stP19memcached_result_st">
223 <span id=
"_CPPv323memcached_result_createP12memcached_stP19memcached_result_st"></span><span id=
"_CPPv223memcached_result_createP12memcached_stP19memcached_result_st"></span><span id=
"memcached_result_create__memcached_stP.memcached_result_stP"></span><a class=
"reference internal" href=
"#_CPPv419memcached_result_st" title=
"memcached_result_st">memcached_result_st
</a> *
<code class=
"sig-name descname">memcached_result_create
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"memcached_create.html#_CPPv412memcached_st" title=
"memcached_st">memcached_st
</a> *
<em>ptr
</em>,
<a class=
"reference internal" href=
"#_CPPv419memcached_result_st" title=
"memcached_result_st">memcached_result_st
</a> *
<em>result
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv423memcached_result_createP12memcached_stP19memcached_result_st" title=
"Permalink to this definition">¶
</a><br /></dt>
226 <dl class=
"function">
227 <dt id=
"_CPPv421memcached_result_freeP19memcached_result_st">
228 <span id=
"_CPPv321memcached_result_freeP19memcached_result_st"></span><span id=
"_CPPv221memcached_result_freeP19memcached_result_st"></span><span id=
"memcached_result_free__memcached_result_stP"></span>void
<code class=
"sig-name descname">memcached_result_free
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"#_CPPv419memcached_result_st" title=
"memcached_result_st">memcached_result_st
</a> *
<em>result
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv421memcached_result_freeP19memcached_result_st" title=
"Permalink to this definition">¶
</a><br /></dt>
231 <dl class=
"function">
232 <dt id=
"_CPPv426memcached_result_key_valueP19memcached_result_st">
233 <span id=
"_CPPv326memcached_result_key_valueP19memcached_result_st"></span><span id=
"_CPPv226memcached_result_key_valueP19memcached_result_st"></span><span id=
"memcached_result_key_value__memcached_result_stP"></span><em class=
"property">const
</em> char *
<code class=
"sig-name descname">memcached_result_key_value
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"#_CPPv419memcached_result_st" title=
"memcached_result_st">memcached_result_st
</a> *
<em>result
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv426memcached_result_key_valueP19memcached_result_st" title=
"Permalink to this definition">¶
</a><br /></dt>
236 <dl class=
"function">
237 <dt id=
"_CPPv427memcached_result_key_lengthPK19memcached_result_st">
238 <span id=
"_CPPv327memcached_result_key_lengthPK19memcached_result_st"></span><span id=
"_CPPv227memcached_result_key_lengthPK19memcached_result_st"></span><span id=
"memcached_result_key_length__memcached_result_stCP"></span>size_t
<code class=
"sig-name descname">memcached_result_key_length
</code><span class=
"sig-paren">(
</span><em class=
"property">const
</em> <a class=
"reference internal" href=
"#_CPPv419memcached_result_st" title=
"memcached_result_st">memcached_result_st
</a> *
<em>result
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv427memcached_result_key_lengthPK19memcached_result_st" title=
"Permalink to this definition">¶
</a><br /></dt>
241 <dl class=
"function">
242 <dt id=
"_CPPv422memcached_result_valueP19memcached_result_st">
243 <span id=
"_CPPv322memcached_result_valueP19memcached_result_st"></span><span id=
"_CPPv222memcached_result_valueP19memcached_result_st"></span><span id=
"memcached_result_value__memcached_result_stP"></span><em class=
"property">const
</em> char *
<code class=
"sig-name descname">memcached_result_value
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"#_CPPv419memcached_result_st" title=
"memcached_result_st">memcached_result_st
</a> *
<em>ptr
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv422memcached_result_valueP19memcached_result_st" title=
"Permalink to this definition">¶
</a><br /></dt>
246 <dl class=
"function">
247 <dt id=
"_CPPv427memcached_result_take_valueP19memcached_result_st">
248 <span id=
"_CPPv327memcached_result_take_valueP19memcached_result_st"></span><span id=
"_CPPv227memcached_result_take_valueP19memcached_result_st"></span><span id=
"memcached_result_take_value__memcached_result_stP"></span>char *
<code class=
"sig-name descname">memcached_result_take_value
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"#_CPPv419memcached_result_st" title=
"memcached_result_st">memcached_result_st
</a> *
<em>ptr
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv427memcached_result_take_valueP19memcached_result_st" title=
"Permalink to this definition">¶
</a><br /></dt>
251 <dl class=
"function">
252 <dt id=
"_CPPv423memcached_result_lengthPK19memcached_result_st">
253 <span id=
"_CPPv323memcached_result_lengthPK19memcached_result_st"></span><span id=
"_CPPv223memcached_result_lengthPK19memcached_result_st"></span><span id=
"memcached_result_length__memcached_result_stCP"></span>size_t
<code class=
"sig-name descname">memcached_result_length
</code><span class=
"sig-paren">(
</span><em class=
"property">const
</em> <a class=
"reference internal" href=
"#_CPPv419memcached_result_st" title=
"memcached_result_st">memcached_result_st
</a> *
<em>ptr
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv423memcached_result_lengthPK19memcached_result_st" title=
"Permalink to this definition">¶
</a><br /></dt>
256 <dl class=
"function">
257 <dt id=
"_CPPv422memcached_result_flagsPK19memcached_result_st">
258 <span id=
"_CPPv322memcached_result_flagsPK19memcached_result_st"></span><span id=
"_CPPv222memcached_result_flagsPK19memcached_result_st"></span><span id=
"memcached_result_flags__memcached_result_stCP"></span>uint32_t
<code class=
"sig-name descname">memcached_result_flags
</code><span class=
"sig-paren">(
</span><em class=
"property">const
</em> <a class=
"reference internal" href=
"#_CPPv419memcached_result_st" title=
"memcached_result_st">memcached_result_st
</a> *
<em>result
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv422memcached_result_flagsPK19memcached_result_st" title=
"Permalink to this definition">¶
</a><br /></dt>
261 <dl class=
"function">
262 <dt id=
"_CPPv420memcached_result_casPK19memcached_result_st">
263 <span id=
"_CPPv320memcached_result_casPK19memcached_result_st"></span><span id=
"_CPPv220memcached_result_casPK19memcached_result_st"></span><span id=
"memcached_result_cas__memcached_result_stCP"></span>uint64_t
<code class=
"sig-name descname">memcached_result_cas
</code><span class=
"sig-paren">(
</span><em class=
"property">const
</em> <a class=
"reference internal" href=
"#_CPPv419memcached_result_st" title=
"memcached_result_st">memcached_result_st
</a> *
<em>result
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv420memcached_result_casPK19memcached_result_st" title=
"Permalink to this definition">¶
</a><br /></dt>
266 <dl class=
"function">
267 <dt id=
"_CPPv426memcached_result_set_valueP19memcached_result_stPKc6size_t">
268 <span id=
"_CPPv326memcached_result_set_valueP19memcached_result_stPKc6size_t"></span><span id=
"_CPPv226memcached_result_set_valueP19memcached_result_stPKc6size_t"></span><span id=
"memcached_result_set_value__memcached_result_stP.cCP.s"></span><a class=
"reference internal" href=
"memcached_return_t.html#_CPPv418memcached_return_t" title=
"memcached_return_t">memcached_return_t
</a> <code class=
"sig-name descname">memcached_result_set_value
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"#_CPPv419memcached_result_st" title=
"memcached_result_st">memcached_result_st
</a> *
<em>ptr
</em>,
<em class=
"property">const
</em> char *
<em>value
</em>, size_t
<em>length
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv426memcached_result_set_valueP19memcached_result_stPKc6size_t" title=
"Permalink to this definition">¶
</a><br /></dt>
271 <dl class=
"function">
272 <dt id=
"_CPPv426memcached_result_set_flagsP19memcached_result_st8uint32_t">
273 <span id=
"_CPPv326memcached_result_set_flagsP19memcached_result_st8uint32_t"></span><span id=
"_CPPv226memcached_result_set_flagsP19memcached_result_st8uint32_t"></span><span id=
"memcached_result_set_flags__memcached_result_stP.uint32_t"></span>void
<code class=
"sig-name descname">memcached_result_set_flags
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"#_CPPv419memcached_result_st" title=
"memcached_result_st">memcached_result_st
</a> *
<em>ptr
</em>, uint32_t
<em>flags
</em><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv426memcached_result_set_flagsP19memcached_result_st8uint32_t" title=
"Permalink to this definition">¶
</a><br /></dt>
276 <dl class=
"function">
277 <dt id=
"_CPPv431memcached_result_set_expirationP19memcached_result_st6time_t">
278 <span id=
"_CPPv331memcached_result_set_expirationP19memcached_result_st6time_t"></span><span id=
"_CPPv231memcached_result_set_expirationP19memcached_result_st6time_t"></span><span id=
"memcached_result_set_expiration__memcached_result_stP.time_t"></span>void
<code class=
"sig-name descname">memcached_result_set_expiration
</code><span class=
"sig-paren">(
</span><a class=
"reference internal" href=
"#_CPPv419memcached_result_st" title=
"memcached_result_st">memcached_result_st
</a> *
<em>ptr
</em>, time_t
<span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv431memcached_result_set_expirationP19memcached_result_st6time_t" title=
"Permalink to this definition">¶
</a><br /></dt>
281 <p>Compile and link with -lmemcachedutil -lmemcached
</p>
283 <div class=
"section" id=
"description">
284 <h2>DESCRIPTION
<a class=
"headerlink" href=
"#description" title=
"Permalink to this headline">¶
</a></h2>
285 <p>libmemcached(
3) can optionally return a
<a class=
"reference internal" href=
"#_CPPv419memcached_result_st" title=
"memcached_result_st"><code class=
"xref cpp cpp-type docutils literal notranslate"><span class=
"pre">memcached_result_st
</span></code></a> which
286 acts as a result object. The result objects have added benefits over the
287 character pointer returns, in that they are forward compatible with new
288 return items that future memcached servers may implement (the best current
289 example of this is the CAS return item). The structures can also be reused,
290 which will save on calls to malloc(
3). It is suggested that you use result
291 objects over char * return functions.
</p>
292 <p>The structure of
<a class=
"reference internal" href=
"#_CPPv419memcached_result_st" title=
"memcached_result_st"><code class=
"xref cpp cpp-type docutils literal notranslate"><span class=
"pre">memcached_result_st
</span></code></a> has been encapsulated, you should
293 not write code to directly access members of the structure.
</p>
294 <p><a class=
"reference internal" href=
"#_CPPv423memcached_result_createP12memcached_stP19memcached_result_st" title=
"memcached_result_create"><code class=
"xref cpp cpp-func docutils literal notranslate"><span class=
"pre">memcached_result_create()
</span></code></a> will either allocate memory for a
295 <a class=
"reference internal" href=
"#_CPPv419memcached_result_st" title=
"memcached_result_st"><code class=
"xref cpp cpp-type docutils literal notranslate"><span class=
"pre">memcached_result_st
</span></code></a> or will initialize a structure passed to it.
</p>
296 <p><a class=
"reference internal" href=
"#_CPPv421memcached_result_freeP19memcached_result_st" title=
"memcached_result_free"><code class=
"xref cpp cpp-func docutils literal notranslate"><span class=
"pre">memcached_result_free()
</span></code></a> will deallocate any memory attached to the
297 structure. If the structure was also allocated, it will deallocate it.
</p>
298 <p><a class=
"reference internal" href=
"#_CPPv426memcached_result_key_valueP19memcached_result_st" title=
"memcached_result_key_value"><code class=
"xref cpp cpp-func docutils literal notranslate"><span class=
"pre">memcached_result_key_value()
</span></code></a> returns the key value associated with the
299 current result object.
</p>
300 <p><a class=
"reference internal" href=
"#_CPPv427memcached_result_key_lengthPK19memcached_result_st" title=
"memcached_result_key_length"><code class=
"xref cpp cpp-func docutils literal notranslate"><span class=
"pre">memcached_result_key_length()
</span></code></a> returns the key length associated with
301 the current result object.
</p>
302 <p><a class=
"reference internal" href=
"#_CPPv422memcached_result_valueP19memcached_result_st" title=
"memcached_result_value"><code class=
"xref cpp cpp-func docutils literal notranslate"><span class=
"pre">memcached_result_value()
</span></code></a> returns the result value associated with the
303 current result object.
</p>
304 <p><a class=
"reference internal" href=
"#_CPPv427memcached_result_take_valueP19memcached_result_st" title=
"memcached_result_take_value"><code class=
"xref cpp cpp-func docutils literal notranslate"><span class=
"pre">memcached_result_take_value()
</span></code></a> returns and hands over the result value
305 associated with the current result object. You must call free() to release this
306 value, unless you have made use of a custom allocator. Use of a custom
307 allocator requires that you create your own custom free() to release it.
</p>
308 <p><a class=
"reference internal" href=
"#_CPPv423memcached_result_lengthPK19memcached_result_st" title=
"memcached_result_length"><code class=
"xref cpp cpp-func docutils literal notranslate"><span class=
"pre">memcached_result_length()
</span></code></a> returns the result length associated with
309 the current result object.
</p>
310 <p><a class=
"reference internal" href=
"#_CPPv422memcached_result_flagsPK19memcached_result_st" title=
"memcached_result_flags"><code class=
"xref cpp cpp-func docutils literal notranslate"><span class=
"pre">memcached_result_flags()
</span></code></a> returns the flags associated with the
311 current result object.
</p>
312 <p><a class=
"reference internal" href=
"#_CPPv420memcached_result_casPK19memcached_result_st" title=
"memcached_result_cas"><code class=
"xref cpp cpp-func docutils literal notranslate"><span class=
"pre">memcached_result_cas()
</span></code></a> returns the cas associated with the
313 current result object. This value will only be available if the server
315 <p><a class=
"reference internal" href=
"#_CPPv426memcached_result_set_valueP19memcached_result_stPKc6size_t" title=
"memcached_result_set_value"><code class=
"xref cpp cpp-func docutils literal notranslate"><span class=
"pre">memcached_result_set_value()
</span></code></a> takes a byte array and a size and sets
316 the result to this value. This function is used for trigger responses.
</p>
317 <p><a class=
"reference internal" href=
"#_CPPv426memcached_result_set_flagsP19memcached_result_st8uint32_t" title=
"memcached_result_set_flags"><code class=
"xref cpp cpp-func docutils literal notranslate"><span class=
"pre">memcached_result_set_flags()
</span></code></a> takes a result structure and stores a new
318 value for the flags field.
</p>
319 <p><a class=
"reference internal" href=
"#_CPPv431memcached_result_set_expirationP19memcached_result_st6time_t" title=
"memcached_result_set_expiration"><code class=
"xref cpp cpp-func docutils literal notranslate"><span class=
"pre">memcached_result_set_expiration()
</span></code></a> takes a result structure and stores
320 a new value for the expiration field (this is only used by read through
322 <p>You may wish to avoid using memcached_result_create(
3) with a
323 stack based allocation. The most common issues related to ABI safety involve
324 heap allocated structures.
</p>
326 <div class=
"section" id=
"return">
327 <h2>RETURN
<a class=
"headerlink" href=
"#return" title=
"Permalink to this headline">¶
</a></h2>
328 <p>Varies, see particular functions. All structures must have
329 <a class=
"reference internal" href=
"#_CPPv421memcached_result_freeP19memcached_result_st" title=
"memcached_result_free"><code class=
"xref cpp cpp-func docutils literal notranslate"><span class=
"pre">memcached_result_free()
</span></code></a> called on them for cleanup purposes. Failure
330 to do this will result in leaked memory.
</p>
332 <div class=
"section" id=
"see-also">
333 <h2>SEE ALSO
<a class=
"headerlink" href=
"#see-also" title=
"Permalink to this headline">¶
</a></h2>
343 <div class=
"rst-footer-buttons" role=
"navigation" aria-label=
"footer navigation">
345 <a href=
"memcached_append.html" class=
"btn btn-neutral float-right" title=
"Appending or Prepending to data on the server" accesskey=
"n" rel=
"next">Next
<span class=
"fa fa-arrow-circle-right"></span></a>
348 <a href=
"memcached_flush_buffers.html" class=
"btn btn-neutral float-left" title=
"Flushing client buffers" accesskey=
"p" rel=
"prev"><span class=
"fa fa-arrow-circle-left"></span> Previous
</a>
355 <div role=
"contentinfo">
357 © <a href=
"../copyright.html">Copyright
</a>
361 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>.
374 <script type=
"text/javascript">
376 SphinxRtdTheme.Navigation.enable(true);