GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MEMCACHED_CREATE (3)

NAME

memcached_create - libmemcached Documentation \$1 \n[an-margin] level \n[rst2man-indent-level] level margin: \n[rst2man-indent\n[rst2man-indent-level]] - \n[rst2man-indent0] \n[rst2man-indent1] \n[rst2man-indent2]
\$1 \n[an-margin] level \n[rst2man-indent-level] level margin: \n[rst2man-indent\n[rst2man-indent-level]] - \n[rst2man-indent0] \n[rst2man-indent1] \n[rst2man-indent2]

CONTENTS

Synopsis
Description
Return
Home
See Also
Author
Copyright

SYNOPSIS

#include <libmemcached/memcached.h>
memcached_st
 

 memcached_st* memcached_create( memcached_st *ptr)
 
void memcached_free( memcached_st *ptr)
 
 memcached_st* memcached_clone( memcached_st *destination,  memcached_st *source)
 
void memcached_servers_reset( memcached_st)
 

Compile and link with -lmemcached

DESCRIPTION

 memcached_create() is used to create a  memcached_st structure that will then be used by other libmemcached(3) functions to communicate with the server. You should either pass a statically declared  memcached_st to  memcached_create() or a NULL. If a NULL passed in then a structure is allocated for you.

Please note, when you write new application use memcached() over  memcached_create().

 memcached_clone() is similar to  memcached_create() but it copies the defaults and list of servers from the source  memcached_st. If you pass a null as the argument for the source to clone, it is the same as a call to  memcached_create(). If the destination argument is NULL a  memcached_st will be allocated for you.

 memcached_servers_reset() allows you to zero out the list of servers that the  memcached_st has.

To clean up memory associated with a  memcached_st structure you should pass it to  memcached_free() when you are finished using it.  memcached_free() is the only way to make sure all memory is deallocated when you finish using the structure.

You may wish to avoid using memcached_create(3) or memcached_clone(3) with a stack based allocation. The most common issues related to ABI safety involve heap allocated structures.

RETURN

 memcached_create() returns a pointer to the  memcached_st that was created (or initialized). On an allocation failure, it returns NULL.

 memcached_clone() returns a pointer to the  memcached_st that was created (or initialized). On an allocation failure, it returns NULL.

HOME

To find out more information please check:  http://libmemcached.org/

SEE ALSO

memcached(1) libmemcached(3) memcached_strerror(3)

AUTHOR

Brian Aker

COPYRIGHT

2011-2013, Brian Aker DataDifferential, http://datadifferential.com/
Search for    or go to Top of page |  Section 3 |  Main Index


1.0.18 MEMCACHED_CREATE (3) February 09, 2014

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.