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  -  LIBMEMCACHED_EXAMPLES (3)

NAME

libmemcached_examples - 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]

Examples for libmemcached

CONTENTS

Description
Connecting To Servers
Creating A Pool Of Servers
Adding A Value To The Server
Fetching Multiple Values
Home
See Also
Author
Copyright

DESCRIPTION

For full examples, test cases are found in tests/*.c in the main distribution. These are always up to date, and are used for each test run of the library.

CONNECTING TO SERVERS


const char *config_string= "--SERVER=host10.example.com --SERVER=host11.example.com --SERVER=host10.example.com"
memcached_st *memc= memcached(config_string, strlen(config_string);
{
...
}
 memcached_free(memc);


In the above code you create a memcached_st object with three server by making use of memcached_create().

CREATING A POOL OF SERVERS


Creating a pool of Servers:


const char *config_string= "--SERVER=host10.example.com --SERVER=host11.example.com --SERVER=host10.example.com";

memcached_pool_st* pool= memcached_pool(config_string, strlen(config_string));

memcached_return_t rc;

memcached_st *memc= memcached_pool_pop(pool, false, &rc);

.... do work

/* Release the memc_ptr that was pulled from the pool */ memcached_pool_push(pool, memc);

/* Destroy the pool. */ memcached_pool_destroy(pool);

In the above code you create a memcached_pool_st object with three server by making use of memcached_pool().

When memcached_pool_destroy() all memory will be released that is associated with the pool.

ADDING A VALUE TO THE SERVER


Adding a value to the Server:


char *key= "foo";
char *value= "value";

memcached_return_t rc= memcached_set(memc, key, strlen(key), value, value_length, (time_t)0, (uint32_t)0);

if (rc != MEMCACHED_SUCCESS) { ... // handle failure }

It is best practice to always look at the return value of any operation.

FETCHING MULTIPLE VALUES


memcached_return_t rc;
char *keys[]= {"fudge", "son", "food"};
size_t key_length[]= {5, 3, 4};
unsigned int x;
uint32_t flags;

char return_key[MEMCACHED_MAX_KEY]; size_t return_key_length; char *return_value; size_t return_value_length;

rc= memcached_mget(memc, keys, key_length, 3);

x= 0; while ((return_value= memcached_fetch(memc, return_key, &return_key_length, &return_value_length, &flags, &rc))) { free(return_value); x++; }

Notice that you freed values returned from memcached_fetch(). The define MEMCACHED_MAX_KEY is provided for usage.

HOME

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

SEE ALSO

memcached(1)

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 LIBMEMCACHED_EXAMPLES (3) February 09, 2014

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