=head1 NAME

memcached_create, memcached_free

=head1 LIBRARY

C Client Library for memcached (libmemcached, -lmemcached)

=head1 SYNOPSIS

#include <memcached.h>
memcached_st *memcached_create(memcached_st *ptr);
void memcached_free(memcached_st *ptr);

=head1 DESCRIPTION


memcached_create() is used to create a memcached_st structure that will then
be used by other libmemcached 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.

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.

=head1 RETURN

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

=head1 HOME

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

=head1 AUTHOR

Brian Aker, brian@tangent.org

=head1 SEE ALSO

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

=cut