# append

### 1. 基本語法

#### **append(`key` , `value`)**&#x20;

如&#x679C;**`key`**&#x503C;為字符串且存在，則&#x5C07;**`value`**&#x5F9E;字符串尾端**黏貼**上，並成為&#x8A72;**`key`**&#x7684;新資料。

&#x20;如&#x679C;**`key`**&#x4E0D;存在，則會建立一個新&#x7684;**`key`**&#x503C;，資料&#x70BA;**`value`**，功能則與[**set**](https://aiii-mike.gitbook.io/redis/command/string/set-get)相似。

### 2. 範例

#### (1) **`key`**&#x5DF2;存在，對應資料加入尾綴

{% tabs %}
{% tab title="TypeScript" %}
```typescript
client.set('foo', 'bar');
client.get('foo', redis.print);

client.append('foo', '_2021');
client.get('foo', redis.print);
```
{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Output-TS" %}
```bash
Reply: bar
Reply: bar_2021
```
{% endtab %}
{% endtabs %}

#### (2) &#x82E5;**`key`**&#x5C1A;未建立，則自動新增資料

{% tabs %}
{% tab title="TypeScript" %}
```typescript
client.del('foo');
client.get('foo', redis.print);

client.append('foo', 'bar_2021');
client.get('foo', redis.print);
```
{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Output-TS" %}
```
Reply: null
Reply: bar_2021
```
{% endtab %}
{% endtabs %}

