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>Getting version information
— libmemcached
1.1.0 documentation
</title>
20 <script type=
"text/javascript" src=
"../_static/js/modernizr.min.js"></script>
23 <script type=
"text/javascript" id=
"documentation_options" data-url_root=
"../" src=
"../_static/documentation_options.js"></script>
24 <script type=
"text/javascript" src=
"../_static/jquery.js"></script>
25 <script type=
"text/javascript" src=
"../_static/underscore.js"></script>
26 <script type=
"text/javascript" src=
"../_static/doctools.js"></script>
27 <script type=
"text/javascript" src=
"../_static/language_data.js"></script>
29 <script type=
"text/javascript" src=
"../_static/js/theme.js"></script>
34 <link rel=
"stylesheet" href=
"../_static/css/theme.css" type=
"text/css" />
35 <link rel=
"stylesheet" href=
"../_static/pygments.css" type=
"text/css" />
36 <link rel=
"index" title=
"Index" href=
"../genindex.html" />
37 <link rel=
"search" title=
"Search" href=
"../search.html" />
38 <link rel=
"copyright" title=
"Copyright" href=
"../copyright.html" />
39 <link rel=
"next" title=
"Deprecated Functionality" href=
"index_deprecated.html" />
40 <link rel=
"prev" title=
"Working with statistical information from a server" href=
"memcached_stats.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">
89 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcached.html">Introduction
</a></li>
90 <li class=
"toctree-l1 current"><a class=
"reference internal" href=
"index.html">libmemcached API
</a><ul class=
"current">
91 <li class=
"toctree-l2"><a class=
"reference internal" href=
"index_basics.html">Basics
</a></li>
92 <li class=
"toctree-l2"><a class=
"reference internal" href=
"index_data.html">Working with Data
</a></li>
93 <li class=
"toctree-l2"><a class=
"reference internal" href=
"index_errors.html">Messages and Errors
</a></li>
94 <li class=
"toctree-l2 current"><a class=
"reference internal" href=
"index_advanced.html">Advanced Topics
</a><ul class=
"current">
95 <li class=
"toctree-l3"><a class=
"reference internal" href=
"index_advanced_internals.html">Internal Behavior
</a></li>
96 <li class=
"toctree-l3"><a class=
"reference internal" href=
"index_advanced_aeh.html">Authentication, Encryption
& Hashing
</a></li>
97 <li class=
"toctree-l3"><a class=
"reference internal" href=
"index_advanced_servers.html">Servers and Server Lists
</a></li>
98 <li class=
"toctree-l3"><a class=
"reference internal" href=
"index_advanced_daemon.html">Affecting the memcached Daemon
</a></li>
99 <li class=
"toctree-l3 current"><a class=
"reference internal" href=
"index_advanced_stats.html">Statistics
</a><ul class=
"current">
100 <li class=
"toctree-l4"><a class=
"reference internal" href=
"memcached_analyze.html">Analyzing servers
</a></li>
101 <li class=
"toctree-l4"><a class=
"reference internal" href=
"memcached_stats.html">Working with statistical information from a server
</a></li>
102 <li class=
"toctree-l4 current"><a class=
"current reference internal" href=
"#">Getting version information
</a></li>
107 <li class=
"toctree-l2"><a class=
"reference internal" href=
"index_deprecated.html">Deprecated Functionality
</a></li>
110 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libmemcachedutil/index.html">libmemcachedutil API
</a></li>
111 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../libhashkit/index.html">libhashkit API
</a></li>
112 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../bin/index.html">Client Applications
</a></li>
113 <li class=
"toctree-l1"><a class=
"reference internal" href=
"index_misc.html">Miscellaneous
</a></li>
116 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../changelogs.html">Change Logs
</a></li>
117 <li class=
"toctree-l1"><a class=
"reference internal" href=
"../copyright.html">Copyright
</a></li>
126 <section data-toggle=
"wy-nav-shift" class=
"wy-nav-content-wrap">
129 <nav class=
"wy-nav-top" aria-label=
"top navigation">
131 <i data-toggle=
"wy-nav-top" class=
"fa fa-bars"></i>
132 <a href=
"../index.html">libmemcached
</a>
137 <div class=
"wy-nav-content">
139 <div class=
"rst-content">
157 <div role=
"navigation" aria-label=
"breadcrumbs navigation">
159 <ul class=
"wy-breadcrumbs">
161 <li><a href=
"../index.html">Docs
</a> »</li>
163 <li><a href=
"index.html">libmemcached API
</a> »</li>
165 <li><a href=
"index_advanced.html">Advanced Topics
</a> »</li>
167 <li><a href=
"index_advanced_stats.html">Statistics
</a> »</li>
169 <li>Getting version information
</li>
172 <li class=
"wy-breadcrumbs-aside">
176 <a href=
"https://github.com/m6w6/libmemcached/blob/v1.x/docs/source/libmemcached/memcached_version.rst" class=
"fa fa-github"> Edit on GitHub
</a>
187 <div role=
"main" class=
"document" itemscope=
"itemscope" itemtype=
"http://schema.org/Article">
188 <div itemprop=
"articleBody">
190 <div class=
"section" id=
"getting-version-information">
191 <h1>Getting version information
<a class=
"headerlink" href=
"#getting-version-information" title=
"Permalink to this headline">¶
</a></h1>
192 <div class=
"section" id=
"synopsis">
193 <h2>SYNOPSIS
<a class=
"headerlink" href=
"#synopsis" title=
"Permalink to this headline">¶
</a></h2>
194 <dl class=
"docutils">
195 <dt>#include
<libmemcached/memcached.h
></dt>
196 <dd>Compile and link with -lmemcached
</dd>
198 <dl class=
"function">
199 <dt id=
"_CPPv421memcached_lib_versionv">
200 <span id=
"_CPPv321memcached_lib_versionv"></span><span id=
"_CPPv221memcached_lib_versionv"></span><span id=
"memcached_lib_version__void"></span><em class=
"property">const
</em> char *
<code class=
"descname">memcached_lib_version
</code><span class=
"sig-paren">(
</span>void
<span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv421memcached_lib_versionv" title=
"Permalink to this definition">¶
</a><br /></dt>
201 <dd><table class=
"docutils field-list" frame=
"void" rules=
"none">
202 <col class=
"field-name" />
203 <col class=
"field-body" />
205 <tr class=
"field-odd field"><th class=
"field-name">Returns:
</th><td class=
"field-body">version string of
<code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">libmemcached
</span></code></td>
211 <dl class=
"function">
212 <dt id=
"_CPPv417memcached_versionP12memcached_st">
213 <span id=
"_CPPv317memcached_versionP12memcached_st"></span><span id=
"_CPPv217memcached_versionP12memcached_st"></span><span id=
"memcached_version__memcached_stP"></span><a class=
"reference internal" href=
"memcached_return_t.html#_CPPv418memcached_return_t" title=
"memcached_return_t">memcached_return_t
</a> <code class=
"descname">memcached_version
</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><span class=
"sig-paren">)
</span><a class=
"headerlink" href=
"#_CPPv417memcached_versionP12memcached_st" title=
"Permalink to this definition">¶
</a><br /></dt>
214 <dd><table class=
"docutils field-list" frame=
"void" rules=
"none">
215 <col class=
"field-name" />
216 <col class=
"field-body" />
218 <tr class=
"field-odd field"><th class=
"field-name">Parameters:
</th><td class=
"field-body"><strong>ptr
</strong> -- pointer to 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
</td>
220 <tr class=
"field-even field"><th class=
"field-name">Returns:
</th><td class=
"field-body"><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
</td>
227 <div class=
"section" id=
"description">
228 <h2>DESCRIPTION
<a class=
"headerlink" href=
"#description" title=
"Permalink to this headline">¶
</a></h2>
229 <p><a class=
"reference internal" href=
"#_CPPv421memcached_lib_versionv" title=
"memcached_lib_version"><code class=
"xref cpp cpp-func docutils literal notranslate"><span class=
"pre">memcached_lib_version()
</span></code></a> is used to return a simple version string
230 representing the
<code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">libmemcached
</span></code> version (client library, not server).
</p>
231 <p><a class=
"reference internal" href=
"#_CPPv417memcached_versionP12memcached_st" title=
"memcached_version"><code class=
"xref cpp cpp-func docutils literal notranslate"><span class=
"pre">memcached_version()
</span></code></a> is used to set the major, minor, and micro versions of
232 each memcached server being used by 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> connection structure.
233 It returns the memcached server return code.
</p>
235 <div class=
"section" id=
"return-value">
236 <h2>RETURN VALUE
<a class=
"headerlink" href=
"#return-value" title=
"Permalink to this headline">¶
</a></h2>
237 <p><a class=
"reference internal" href=
"#_CPPv421memcached_lib_versionv" title=
"memcached_lib_version"><code class=
"xref cpp cpp-func docutils literal notranslate"><span class=
"pre">memcached_lib_version()
</span></code></a> returns a string with the version of the libmemcached driver.
</p>
238 <p>A value of
<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> is returned from :func:'memcached_version'
</p>
239 <p>On success that value will be
<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>.
</p>
240 <p>If called with the
<a class=
"reference internal" href=
"memcached_behavior.html#_CPPv4N20memcached_behavior_t26MEMCACHED_BEHAVIOR_USE_UDPE" title=
"MEMCACHED_BEHAVIOR_USE_UDP"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">MEMCACHED_BEHAVIOR_USE_UDP
</span></code></a> behavior set, the value
241 <a class=
"reference internal" href=
"memcached_return_t.html#_CPPv4N18memcached_return_t23MEMCACHED_NOT_SUPPORTEDE" title=
"MEMCACHED_NOT_SUPPORTED"><code class=
"xref cpp cpp-any docutils literal notranslate"><span class=
"pre">MEMCACHED_NOT_SUPPORTED
</span></code></a> will be returned.
</p>
242 <p>Use
<a class=
"reference internal" href=
"memcached_strerror.html#_CPPv418memcached_strerrorP12memcached_st18memcached_return_t" title=
"memcached_strerror"><code class=
"xref cpp cpp-func docutils literal notranslate"><span class=
"pre">memcached_strerror()
</span></code></a> to translate this value to
243 a printable string.
</p>
245 <div class=
"section" id=
"see-also">
246 <h2>SEE ALSO
<a class=
"headerlink" href=
"#see-also" title=
"Permalink to this headline">¶
</a></h2>
256 <div class=
"rst-footer-buttons" role=
"navigation" aria-label=
"footer navigation">
258 <a href=
"index_deprecated.html" class=
"btn btn-neutral float-right" title=
"Deprecated Functionality" accesskey=
"n" rel=
"next">Next
<span class=
"fa fa-arrow-circle-right"></span></a>
261 <a href=
"memcached_stats.html" class=
"btn btn-neutral float-left" title=
"Working with statistical information from a server" accesskey=
"p" rel=
"prev"><span class=
"fa fa-arrow-circle-left"></span> Previous
</a>
268 <div role=
"contentinfo">
270 © <a href=
"../copyright.html">Copyright
</a>
274 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>.
287 <script type=
"text/javascript">
289 SphinxRtdTheme.Navigation.enable(true);