libmemcached 의 기반 함수를 사용하면 memcached 서버와의 인터페이스로 사용되는 memcached_st 주요 구조체를 생성, 파괴 및 복제 할 수 있습니다. 주요 함수의 정의를 보여줍니다.

 memcached_st *memcached_create (memcached_st *ptr);

다른 libmemcached API 함수에서 사용하는 새로운 memcached_st 구조를 만듭니다. 기존의 정적 memcached_st 구조를 지정하거나 NULL 을 지정해 새로운 구조체를 할당 할 수 있습니다. 생성 된 구조체에 대한 포인터를 반환합니다. 실패시 NULL 을 반환합니다.

 void memcached_free (memcached_st *ptr);

이전에 작성된 memcached_st 구조체에 할당 된 구조체와 메모리를 해제합니다.

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

지정된 source 에서 기존 memcached 구조를 복제하고 그 구조체에 정의되어있는 기본 및 서버 목록을 복사합니다.

libmemcached API는 memcached_server_st 구조에 저장되어있는 서버 목록을 사용하여 나머지 함수에서 사용되는 서버 목록 역할을합니다. memcached 를 사용하려면 먼저 서버 목록을 만든 다음 해당 서버 목록을 유효한 libmemcached 객체에 적용합니다.

이 서버 목록과 활성 libmemcached 개체의 서버 목록은 별도로 조작 할 수 있기 때문에 활성 libmemcached 인터페이스를 실행하는 동안 서버 목록을 업데이트하고 관리 할 수 있습니다.

memcached_st 구조의 서버 목록을 조작하는 함수는 다음과 같습니다.

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

지정된 hostname 과 port 를 사용하여 ptr 에 지정된 memcached_st 구조에 서버를 추가합니다.

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

memcached_st 구조로 구성된 서버 목록에 Unix 소켓을 추가합니다.

 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 와 key_length 은 키의 이름과 길이를 정의하고 value 와 value_length 는 해당 값과 길이를 정의합니다. 취소 및 옵션 플래그를 설정할 수도 있습니다. 자세한 내용은 섹션 16.6.3.3.5 " libmemcached 의 동작 제어 " 를 참조하십시오.

이 표는 libmemcached 의 나머지 설정 관련 함수와 memcached 프로토콜에서 지원되는 동일한 코어 함수의 개요를 나타냅니다.

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

모든 함수가 MEMCACHED_SUCCESS 상수와 비교할 수 memcached_return 형의 값을 돌려줍니다.

libmemcached 함수는 하나의 항목에 직접 액세스와 여러 키를 동시에 가져올 때 응답이 매우 빠르게 여러 키 요청 메커니즘을 제공합니다.

일반 get() 과 동등한 주요 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);

여러 키 get이다 memcached_mget() 도 사용 가능합니다. 여러 키 가져 오기 작업을 사용하면 memcached_get() 를 개별적으로 호출하여 키 값을 검색하는 것보다 1 블록의 작업을 매우 빠르게 수행 할 수 있습니다. 여러 키 검색을 시작하려면 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;
}

위의 응용 프로그램을 실행하면 다음과 같은 출력이 생성됩니다.

shell> 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 동작 플래그를 다음 표에 나타냅니다.

libmemcached 에는 주요 C 라이브러리 인터페이스뿐만 아니라, memcached 응용 프로그램의 조작이나 디버깅에 도움이되는 몇 가지 명령 행 유틸리티가 포함되어 있습니다.

모든 명령 줄 도구는 몇 가지 인수를 허용하지만 그 중 가장 중요한 것은 정보를 반환 할 때 연결할 서버의 목록을 지정 servers 입니다.

주요 도구는 다음과 같습니다.