libmemcached API介绍

#include <libmemcached/memcached.h>

memcachd_st  ；该结构可以静态创建也可以由 memcached_create 动态创建。

memcached_st* memcached_create(memcached_st *ptr)

ptr 不为空时是静态创建，如果 ptr 为空，那么该函数返回一个 memcached_st 结构。

void memcached_free(memcached_st *ptr)

释放 memcached_st 结构所用的内存，删除 memcached_st 。

memcached_st* memcached_clone(memcached_st *destination, memcached_st *source)

克隆一个 memcached_st 结构；如果 source 为空，那么其作用和 memcached_create一样，如果destination为空，则该函数的返回值将会返回一个和source一样的memcached_st结构。

void memcached_servers_reset(memcached_st)

将memcached_st所拥有与服务器的连接全都断开。

Compile and link with –lmemcached

2.     Memcached_return_t的返回值。

MEMCACHED_SUCCESS表示操作成功，其他均表示错误；其他错误的详情参考：http://docs.libmemcached.org/error_messages.html。

3.       增加和减少值。

#include <libmemcached/memcached.h>

memcached_return_t memcached_increment (memcached_st *ptr, const char *key, size_t key_length, unsigned int offset, uint64_t *value)

memcached_return_t memcached_decrement (memcached_st *ptr, const char *key, size_t key_length, unsigned int offset, uint64_t *value)

offset是其增加或者减少的数值，改变后的值通过value指针返回。

其他增加和减少操作参见：

http://docs.libmemcached.org/memcached_auto.html。

4.       从服务器获取值。

#include <libmemcached/memcached.h>

char * memcached_get(memcached_st *ptr, const char *key, size_t key_length, size_t *value_length, uint32_t *flags, memcached_return_t *error)；

一次通过一个键获取一个值。

memcached_return_t   memcached_mget(memcached_st  *ptr , const char * const  *keys , const size_t  *key_length , size_t  number_of_keys )

memcached_result_st   *   memcached_fetch_result(memcached_st  *ptr ,   memcached_result_st  *result ,   memcached_return_t  *error )

以上两个函数同时配合使用，一次调用可以通过多个键获取多个值。先通过 memcached_mget 调用获取多个键的值，这些值通过循环调用 memcached_fetch_result 来获得每一个键所对应的值，直到该函数返回 0 。

5.       Store， Add and Replace的操作。

memcached_return_t memcached_set (memcached_st *ptr, const char *key, size_t key_length, const char *value, size_t value_length, time_t expiration, uint32_t flags);

memcached中如果存在该键，则利用新值去替换，否则将该记录写入memcached中。

memcached_return_t memcached_add (memcached_st *ptr, const char *key, size_t key_length, const char *value, size_t value_length, time_t expiration, uint32_t flags);

如果memcached中存在该键，发生错误；否则将该记录添加进memcached中。

memcached_return_t memcached_replace (memcached_st *ptr, const char *key, size_t key_length, const char *value, size_t value_length, time_t expiration, uint32_t flags);

如果memcached中没有该键，发生错误；否则替换value。

以上三个函数中，key的长度不能超过250个字符，value是一个16个字节的值。Expiration是该记录在memcached的有效时间，即是超时时间。

6.       删除操作。

memcached_return_t memcached_delete (memcached_st *ptr, const char *key, size_t key_length, time_t expiration);

该函数将与key对应的记录放入删除队列中，并且通过expiration指定该记录从服务器删除的时间。

7.       断开客户端与服务器的连接。

void memcached_quit (memcached_st *ptr);

使用遇到的：

memcached_server_list_st memcached_server_list_append(memcached_server_list_st list, const char *hostname, unsigned int port,  memcached_return_t  *error)

该函数是将要连接的服务器添加到memcached_server_st数组中，返回值为NULL时表示出现错误，如果未指定port端口则使用默认的端口。

memcached_return_t  memcached_server_push(memcached_st *ptr, const memcached_server_st *list)

该函数将 memcached_server_st数组添加到memcached_st结构中。

void memcached_server_list_free(memcached_server_list_st list)

释放memcached_server_list_st所占据的内存。

原文：http://blog.csdn.net/nyist327/article/details/44491107