---
name: "memcached_server_list_append"
section: "3"
platform: "linux"
package: "libmemcached-awesome"
version: "1.1.4-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/memcached_server_list_append"
---

# memcached\_server\_list\_append(3)

libmemcached Documentation

## NAME

memcached\_server\_list\_append - libmemcached Documentation

## SYNOPSIS

- **#include \<libmemcached/memcached.h\>**

  Compile and link with -lmemcached

- **typedef struct memcached\_instance\_st memcached\_instance\_st**

  - **typedef struct memcached\_server\_st memcached\_server\_st**

  - **typedef struct memcached\_server\_st \*memcached\_server\_list\_st**

  - **void memcached\_server\_list\_free(memcached\_server\_list\_st list)**

  - **Parameters**

    **list** -- instance of initialized **memcached\_server\_list\_st** object

- **memcached\_server\_list\_st memcached\_server\_list\_append(memcached\_server\_list\_st list, const char \*hostname, in\_port\_t port, memcached\_return\_t \<#\_CPPv418memcached\_return\_t\> \*error)**

  - **Parameters**

    - •

      **list** -- instance of an existing **memcached\_server\_list\_st** or nullptr to create one

    - •

      **hostname** -- the hostname or path to the socket, defaults to localhost if null

    - •

      **port** -- the port to use, defaults to 11211 if 0

    - •

      **error** -- pointer to store any **memcached\_return\_t** \<#\_CPPv418memcached\_return\_t\> error indicating success

  - **Returns**

    new instance of **memcached\_server\_list\_st** on success or nullptr on failure

- **uint32\_t memcached\_server\_list\_count(memcached\_server\_list\_st list)**

  - **Parameters**

    **list** -- instance of **memcached\_server\_list\_st**

  - **Returns**

    count of servers in the list

- **const char \*memcached\_server\_error(const memcached\_instance\_st \*instance)**

  - **Parameters**

    **instance** -- pointer to an initialized **memcached\_instance\_st** object

  - **Returns**

    last error message sent from the server to the client

- **void memcached\_server\_error\_reset(const memcached\_instance\_st \*list)**

  Deprecated since version 0.39.

- **void memcached\_servers\_parse()**

  Deprecated since version 0.39.

  See **memcached()** \<#\_CPPv49memcachedPKc6size\_t\>.

## DESCRIPTION

**libmemcached** operates on a list of hosts which are stored in **memcached\_server\_st** structures. You should not modify these structures directly. Functions are provided to modify these structures.

**memcached\_server\_list()** is used to provide an array of all defined hosts. This was incorrectly documented as "requiring free" up till version 0.39.

**memcached\_server\_list\_free()** deallocates all memory associated with the array of **memcached\_server\_st** that you passed to it.

**memcached\_server\_list\_append()** adds a server to the end of a **memcached\_server\_st** array. On error null will be returned and the **memcached\_return\_t** \<#\_CPPv418memcached\_return\_t\> pointer you passed into the function will be set with the appropriate error. If the value of port is zero, it is set to the default port of a memcached server.

DEPRECATED **memcached\_servers\_parse()**, please see **memcached()** \<#\_CPPv49memcachedPKc6size\_t\>

**memcached\_server\_error()** can be used to look at the text of the last error message sent by the server to to the client.

Before version 0.39 theses functions used a memcached\_server\_st \*. In 0.39 memcached\_server\_st \* was aliased to **memcached\_server\_list\_st**. This was done for a style reason to help clean up some concepts in the code.

## RETURN VALUE

Varies, see particular functions.

## SEE ALSO

**[memcached(1)](/memcached/1.md) \<https://linux.die.net/man/1/memcached\>** **[libmemcached(3)](/libmemcached/3.md) \<https://linux.die.net/man/3/libmemcached\>** **[memcached\_servers(3)](/memcached_servers/3.md) \<https://linux.die.net/man/3/memcached\_servers\>** **[memcached\_strerror(3)](/memcached_strerror/3.md) \<https://linux.die.net/man/3/memcached\_strerror\>**