基本libmemcached函数允许您创建、销毁和克隆 memcached_st用于与memcached服务器交互的主要结构。主要函数定义如下：

memcached_st *memcached_create (memcached_st *ptr);

创建memcached_st用于其他libmemcachedAPI 函数的新结构。您可以提供现有的静态 memcached_st结构，或 NULL分配新的结构。返回指向创建的结构的指针，或 NULL失败。

void memcached_free (memcached_st *ptr);

释放分配给先前创建的memcached_st结构的结构和内存。

memcached_st *memcached_clone(memcached_st *clone, memcached_st *source);

memcached从指定的 克隆现有结构source，复制结构中定义的默认值和服务器列表。

libmemcachedAPI 使用存储在 结构中 的memcached_server_st服务器列表作为其余函数使用的服务器列表。要使用 memcached，您首先要创建服务器列表，然后将服务器列表应用于有效 libmemcached对象。

因为服务器列表和活动libmemcached对象中的服务器列表可以单独操作，所以您可以在活动libmemcached界面运行时更新和管理服务器列表。

memcached_st在一个结构中 操作服务器列表的函数 是：

memcached_return
   memcached_server_add (memcached_st *ptr,
                         char *hostname,
                         unsigned int port);

添加一个服务器，使用给定的hostname和 port到中 memcached_st给定的结构 ptr。

memcached_return
   memcached_server_add_unix_socket (memcached_st *ptr,
                                     char *socket);

将 Unix 套接字添加到 memcached_st结构中配置的服务器列表中。

unsigned int memcached_server_count (memcached_st *ptr);

返回结构中已配置服务器的数量 memcached_st。

memcached_server_st *
   memcached_server_list (memcached_st *ptr);

返回结构中所有已定义主机的数组 memcached_st。

memcached_return
   memcached_server_push (memcached_st *ptr,
                          memcached_server_st *list);

将现有服务器列表推送到为当前memcached_st 结构配置的服务器列表。这会将服务器添加到现有列表的末尾，并且不会检查重复项。

该memcached_server_st结构可用于创建memcached服务器列表，然后可以将其单独应用于 memcached_st结构。

memcached_server_st *
   memcached_server_list_append (memcached_server_st *ptr,
                                 char *hostname,
                                 unsigned int port,
                                 memcached_return *error);

将带有hostname和 的服务器添加port到 中的服务器列表 ptr。结果代码由 error参数处理，该参数应指向现有memcached_return变量。该函数返回指向返回列表的指针。

unsigned int memcached_server_list_count (memcached_server_st *ptr);

返回服务器列表中的服务器数。

void memcached_server_list_free (memcached_server_st *ptr);

释放与服务器列表关联的内存。

memcached_server_st *memcached_servers_parse (char *server_strings);

解析包含服务器列表的字符串，其中各个服务器由逗号、空格或两者分隔，并且各个服务器的格式为 . 返回值是一个服务器列表结构。 server[:port]

其中的集合相关函数 提供与协议libmemcached支持的核心函数相同的功能 。memcached不同函数的完整定义对于所有基本函数 ( add, replace, prepend, append) 都是相同的。例如，函数定义为 memcached_set()：

memcached_return
   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);

是ptr结构 memcached_st。和 定义键名和长度，以及key和 和对应的值和长度。您还可以设置过期和可选标志。有关详细信息，请参阅 第 16.2.3.3.5 节，“控制行为”。 key_lengthvaluevalue_lengthlibmemcached

下表概述了与集合相关的其余 函数以及memcached 协议 libmemcached支持的等效核心函数。

这些by_key方法添加了两个进一步的参数来定义主密钥，在选择服务器的散列​​阶段使用和应用。您可以在以下定义中看到这一点：

memcached_return
   memcached_set_by_key(memcached_st *ptr,
                        const char *master_key,
                        size_t master_key_length,
                        const char *key,
                        size_t key_length,
                        const char *value,
                        size_t value_length,
                        time_t expiration,
                        uint32_t flags);

所有函数都返回 type 的值 memcached_return，您可以将其与MEMCACHED_SUCCESS常量进行比较。

这些libmemcached函数既提供对单个项目的直接访问，也提供多键请求机制，在同时获取大量键时提供更快的响应。

主要的 get-style 函数，相当于泛型get()是 memcached_get(). 此函数返回一个字符串指针，指向与指定键关联的值。

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

还可以使用多键获取memcached_mget()。在一个块中使用多键获取操作比通过单独调用检索键值要快得多memcached_get()。要启动多键获取，请调用 memcached_mget()：

memcached_return
    memcached_mget (memcached_st *ptr,
                    char **keys, size_t *key_length,
                    unsigned int number_of_keys);

返回值是操作成功。keys参数应该是一个包含键的字符串数组，以及一个 key_length 包含每个对应键的长度的数组。 number_of_keys是数组中提供的键数。

要获取单个值，请使用 memcached_fetch()获取每个相应的值。

char *memcached_fetch (memcached_st *ptr,
                       const char *key, size_t *key_length,
                       size_t *value_length,
                       uint32_t *flags,
                       memcached_return *error);

该函数返回键值 key，并使用相应的键和长度信息填充key_length和 参数。当没有更多的值要返回时，value_length该函数返回。NULL此处提供了一个完整示例，包括密钥数据的填充和信息的返回。

#include <stdio.h>
#include <sstring.h>
#include <unistd.h>
#include <libmemcached/memcached.h>

int main(int argc, char *argv[])
{
  memcached_server_st *servers = NULL;
  memcached_st *memc;
  memcached_return rc;
  char *keys[]= {"huey", "dewey", "louie"};
  size_t key_length[3];
  char *values[]= {"red", "blue", "green"};
  size_t value_length[3];
  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;

  memc= memcached_create(NULL);

  servers= memcached_server_list_append(servers, "localhost", 11211, &rc);
  rc= memcached_server_push(memc, servers);

  if (rc == MEMCACHED_SUCCESS)
    fprintf(stderr,"Added server successfully\n");
  else
    fprintf(stderr,"Couldn't add server: %s\n",memcached_strerror(memc, rc));

  for(x= 0; x < 3; x++)
    {
      key_length[x] = strlen(keys[x]);
      value_length[x] = strlen(values[x]);

      rc= memcached_set(memc, keys[x], key_length[x], values[x],
                        value_length[x], (time_t)0, (uint32_t)0);
      if (rc == MEMCACHED_SUCCESS)
        fprintf(stderr,"Key %s stored successfully\n",keys[x]);
      else
        fprintf(stderr,"Couldn't store key: %s\n",memcached_strerror(memc, rc));
    }

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

  if (rc == MEMCACHED_SUCCESS)
    {
      while ((return_value= memcached_fetch(memc, return_key, &return_key_length,
                                            &return_value_length, &flags, &rc)) != NULL)
        {
          if (rc == MEMCACHED_SUCCESS)
            {
              fprintf(stderr,"Key %s returned %s\n",return_key, return_value);
            }
        }
    }

  return 0;
}

运行上述应用程序会产生以下输出：

$> memc_multi_fetch
Added server successfully
Key huey stored successfully
Key dewey stored successfully
Key louie stored successfully
Key huey returned red
Key dewey returned blue
Key louie returned green

libmemcached可以通过设置一个或多个行为标志来修改 的行为 。这些可以全局设置，也可以在调用单个函数期间应用。一些行为还接受额外的设置，例如选择服务器时使用的散列机制。

设置全局行为：

memcached_return
   memcached_behavior_set (memcached_st *ptr,
                           memcached_behavior flag,
                           uint64_t data);

要获取当前行为设置：

uint64_t
   memcached_behavior_get (memcached_st *ptr,
                           memcached_behavior flag);

下表描述了libmemcached 行为标志。

除了主要的 C 库界面外， libmemcached还包括许多命令行实用程序，这些实用程序在使用和调试memcached应用程序时很有用。

所有命令行工具都接受许多参数，其中最关键的是servers，它指定返回信息时要连接的服务器列表。

主要工具有：