update docs
[m6w6/libmemcached] / libmemcached / memcached_last_error.html
1
2
3 <!DOCTYPE html>
4 <html class="writer-html5" lang="en" >
5 <head>
6 <meta charset="utf-8">
7
8 <meta name="viewport" content="width=device-width, initial-scale=1.0">
9
10 <title>Retrieving Error Codes and Messages &mdash; libmemcached 1.0.99 documentation</title>
11
12
13
14 <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
15 <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
16
17
18
19
20
21
22
23 <!--[if lt IE 9]>
24 <script src="../_static/js/html5shiv.min.js"></script>
25 <![endif]-->
26
27
28 <script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
29 <script src="../_static/jquery.js"></script>
30 <script src="../_static/underscore.js"></script>
31 <script src="../_static/doctools.js"></script>
32 <script src="../_static/language_data.js"></script>
33
34 <script type="text/javascript" src="../_static/js/theme.js"></script>
35
36
37 <link rel="index" title="Index" href="../genindex.html" />
38 <link rel="search" title="Search" href="../search.html" />
39 <link rel="copyright" title="Copyright" href="../copyright.html" />
40 <link rel="next" title="Converting Error Codes to Messages" href="memcached_strerror.html" />
41 <link rel="prev" title="Error Codes - memcached_return_t" href="memcached_return_t.html" />
42 </head>
43
44 <body class="wy-body-for-nav">
45
46
47 <div class="wy-grid-for-nav">
48
49 <nav data-toggle="wy-nav-shift" class="wy-nav-side">
50 <div class="wy-side-scroll">
51 <div class="wy-side-nav-search" >
52
53
54
55 <a href="../index.html" class="icon icon-home" alt="Documentation Home"> libmemcached
56
57
58
59 </a>
60
61
62
63
64 <div class="version">
65 1.0
66 </div>
67
68
69
70
71 <div role="search">
72 <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
73 <input type="text" name="q" placeholder="Search docs" />
74 <input type="hidden" name="check_keywords" value="yes" />
75 <input type="hidden" name="area" value="default" />
76 </form>
77 </div>
78
79
80 </div>
81
82
83 <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
84
85
86
87
88
89
90 <p class="caption"><span class="caption-text">libmemcached</span></p>
91 <ul class="current">
92 <li class="toctree-l1"><a class="reference internal" href="../libmemcached.html">Introduction</a></li>
93 <li class="toctree-l1 current"><a class="reference internal" href="index.html">libmemcached API</a><ul class="current">
94 <li class="toctree-l2"><a class="reference internal" href="index_basics.html">Basics</a></li>
95 <li class="toctree-l2"><a class="reference internal" href="index_data.html">Working with Data</a></li>
96 <li class="toctree-l2 current"><a class="reference internal" href="index_errors.html">Messages and Errors</a><ul class="current">
97 <li class="toctree-l3"><a class="reference internal" href="memcached_return_t.html">Error Codes - memcached_return_t</a></li>
98 <li class="toctree-l3 current"><a class="current reference internal" href="#">Retrieving Error Codes and Messages</a></li>
99 <li class="toctree-l3"><a class="reference internal" href="memcached_strerror.html">Converting Error Codes to Messages</a></li>
100 </ul>
101 </li>
102 <li class="toctree-l2"><a class="reference internal" href="index_advanced.html">Advanced Topics</a></li>
103 <li class="toctree-l2"><a class="reference internal" href="index_deprecated.html">Deprecated Functionality</a></li>
104 </ul>
105 </li>
106 <li class="toctree-l1"><a class="reference internal" href="index_misc.html">Misc</a></li>
107 </ul>
108 <p class="caption"><span class="caption-text">libmemcachedutil</span></p>
109 <ul>
110 <li class="toctree-l1"><a class="reference internal" href="../libmemcachedutil.html">Introduction</a></li>
111 <li class="toctree-l1"><a class="reference internal" href="../libmemcachedutil/index.html">libmemcachedutil API</a></li>
112 </ul>
113 <p class="caption"><span class="caption-text">libhashkit</span></p>
114 <ul>
115 <li class="toctree-l1"><a class="reference internal" href="../libhashkit.html">Introduction</a></li>
116 <li class="toctree-l1"><a class="reference internal" href="../libhashkit/index.html">libhashkit API</a></li>
117 </ul>
118 <p class="caption"><span class="caption-text">Client Applications</span></p>
119 <ul>
120 <li class="toctree-l1"><a class="reference internal" href="../bin/index.html">Client Applications</a></li>
121 </ul>
122 <p class="caption"><span class="caption-text">Copyright</span></p>
123 <ul>
124 <li class="toctree-l1"><a class="reference internal" href="../copyright.html">Copyright</a></li>
125 </ul>
126
127
128
129 </div>
130
131 </div>
132 </nav>
133
134 <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
135
136
137 <nav class="wy-nav-top" aria-label="top navigation">
138
139 <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
140 <a href="../index.html">libmemcached</a>
141
142 </nav>
143
144
145 <div class="wy-nav-content">
146
147 <div class="rst-content">
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165 <div role="navigation" aria-label="breadcrumbs navigation">
166
167 <ul class="wy-breadcrumbs">
168
169 <li><a href="../index.html" class="icon icon-home"></a> &raquo;</li>
170
171 <li><a href="index.html">libmemcached API</a> &raquo;</li>
172
173 <li><a href="index_errors.html">Messages and Errors</a> &raquo;</li>
174
175 <li>Retrieving Error Codes and Messages</li>
176
177
178 <li class="wy-breadcrumbs-aside">
179
180
181
182 </li>
183
184 </ul>
185
186
187 <hr/>
188 </div>
189 <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
190 <div itemprop="articleBody">
191
192 <div class="section" id="retrieving-error-codes-and-messages">
193 <h1>Retrieving Error Codes and Messages<a class="headerlink" href="#retrieving-error-codes-and-messages" title="Permalink to this headline"></a></h1>
194 <div class="section" id="synopsis">
195 <h2>SYNOPSIS<a class="headerlink" href="#synopsis" title="Permalink to this headline"></a></h2>
196 <dl class="simple">
197 <dt>#include &lt;libmemcached/memcached.h&gt;</dt><dd><p>Compile and link with -lmemcached</p>
198 </dd>
199 </dl>
200 <dl class="cpp function">
201 <dt id="_CPPv420memcached_last_errorPK12memcached_st">
202 <span id="_CPPv320memcached_last_errorPK12memcached_st"></span><span id="_CPPv220memcached_last_errorPK12memcached_st"></span><span id="memcached_last_error__memcached_stCP"></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_last_error</code><span class="sig-paren">(</span><em class="property">const</em> <a class="reference internal" href="memcached_create.html#_CPPv412memcached_st" title="memcached_st">memcached_st</a> *<em>ptr</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv420memcached_last_errorPK12memcached_st" title="Permalink to this definition"></a><br /></dt>
203 <dd><dl class="field-list simple">
204 <dt class="field-odd">Parameters</dt>
205 <dd class="field-odd"><p><strong>ptr</strong> -- pointer to an initialized <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> struct</p>
206 </dd>
207 <dt class="field-even">Returns</dt>
208 <dd class="field-even"><p><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> indicating success of last operation</p>
209 </dd>
210 </dl>
211 </dd></dl>
212
213 <dl class="cpp function">
214 <dt id="_CPPv428memcached_last_error_messagePK12memcached_st">
215 <span id="_CPPv328memcached_last_error_messagePK12memcached_st"></span><span id="_CPPv228memcached_last_error_messagePK12memcached_st"></span><span id="memcached_last_error_message__memcached_stCP"></span><em class="property">const</em> char *<code class="sig-name descname">memcached_last_error_message</code><span class="sig-paren">(</span><em class="property">const</em> <a class="reference internal" href="memcached_create.html#_CPPv412memcached_st" title="memcached_st">memcached_st</a> *<em>ptr</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv428memcached_last_error_messagePK12memcached_st" title="Permalink to this definition"></a><br /></dt>
216 <dd><dl class="field-list simple">
217 <dt class="field-odd">Parameters</dt>
218 <dd class="field-odd"><p><strong>ptr</strong> -- pointer to an initialized <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> struct</p>
219 </dd>
220 <dt class="field-even">Returns</dt>
221 <dd class="field-even"><p>message describing the status of last operation</p>
222 </dd>
223 </dl>
224 </dd></dl>
225
226 <dl class="cpp function">
227 <dt id="_CPPv426memcached_last_error_errnoPK12memcached_st">
228 <span id="_CPPv326memcached_last_error_errnoPK12memcached_st"></span><span id="_CPPv226memcached_last_error_errnoPK12memcached_st"></span><span id="memcached_last_error_errno__memcached_stCP"></span>int <code class="sig-name descname">memcached_last_error_errno</code><span class="sig-paren">(</span><em class="property">const</em> <a class="reference internal" href="memcached_create.html#_CPPv412memcached_st" title="memcached_st">memcached_st</a> *<em>ptr</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv426memcached_last_error_errnoPK12memcached_st" title="Permalink to this definition"></a><br /></dt>
229 <dd><dl class="field-list simple">
230 <dt class="field-odd">Parameters</dt>
231 <dd class="field-odd"><p><strong>ptr</strong> -- pointer to an initialized <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> struct</p>
232 </dd>
233 <dt class="field-even">Returns</dt>
234 <dd class="field-even"><p><em class="manpage"><a class="manpage reference external" href="https://linux.die.net/man/3/errno">errno(3)</a></em> (if any) of last operation</p>
235 </dd>
236 </dl>
237 </dd></dl>
238
239 </div>
240 <div class="section" id="description">
241 <h2>DESCRIPTION<a class="headerlink" href="#description" title="Permalink to this headline"></a></h2>
242 <p>Retrieve error codes and messages.</p>
243 </div>
244 <div class="section" id="return-value">
245 <h2>RETURN VALUE<a class="headerlink" href="#return-value" title="Permalink to this headline"></a></h2>
246 <p><a class="reference internal" href="#_CPPv420memcached_last_errorPK12memcached_st" title="memcached_last_error"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">memcached_last_error()</span></code></a> returns the last error code.</p>
247 <p><a class="reference internal" href="#_CPPv428memcached_last_error_messagePK12memcached_st" title="memcached_last_error_message"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">memcached_last_error_message()</span></code></a> returns the last error message. If this error
248 came from a specific server, its hostname and port will be provided in the error
249 message. Any error message will be returned as 'const char *' which does not
250 need to be de-allocated. NULL will be returned if no error has occurred.</p>
251 <p><a class="reference internal" href="#_CPPv426memcached_last_error_errnoPK12memcached_st" title="memcached_last_error_errno"><code class="xref cpp cpp-any docutils literal notranslate"><span class="pre">memcached_last_error_errno()</span></code></a> returns any last local error code obtained from
252 <em class="manpage"><a class="manpage reference external" href="https://linux.die.net/man/3/errno">errno(3)</a></em>.</p>
253 </div>
254 <div class="section" id="see-also">
255 <h2>SEE ALSO<a class="headerlink" href="#see-also" title="Permalink to this headline"></a></h2>
256 <ul class="simple">
257 <li><p><em class="manpage"><a class="manpage reference external" href="https://linux.die.net/man/1/memcached">memcached(1)</a></em></p></li>
258 <li><p><em class="manpage"><a class="manpage reference external" href="https://linux.die.net/man/3/errno">errno(3)</a></em></p></li>
259 <li><p><a class="reference internal" href="../libmemcached.html"><span class="doc">C/C++ Client Library for memcached</span></a></p></li>
260 <li><p><a class="reference internal" href="memcached_strerror.html"><span class="doc">Converting Error Codes to Messages</span></a></p></li>
261 </ul>
262 </div>
263 </div>
264
265
266 </div>
267
268 </div>
269 <footer>
270
271 <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
272
273 <a href="memcached_strerror.html" class="btn btn-neutral float-right" title="Converting Error Codes to Messages" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
274
275
276 <a href="memcached_return_t.html" class="btn btn-neutral float-left" title="Error Codes - memcached_return_t" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
277
278 </div>
279
280
281 <hr/>
282
283 <div role="contentinfo">
284 <p>
285
286
287 &copy; <a href="../copyright.html">Copyright</a>
288
289 </p>
290 </div>
291
292
293
294 Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a
295
296 <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a>
297
298 provided by <a href="https://readthedocs.org">Read the Docs</a>.
299
300 </footer>
301
302 </div>
303 </div>
304
305 </section>
306
307 </div>
308
309
310 <script type="text/javascript">
311 jQuery(function () {
312 SphinxRtdTheme.Navigation.enable(true);
313 });
314 </script>
315
316
317
318
319
320
321 </body>
322 </html>