本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# ARRAY\$1JOIN 函數
<a name="array_join"></a>

ARRAY\$1JOIN 函數需要兩個引數：第一個引數是將聯結的輸入陣列。第二個引數是用來串連陣列元素的分隔符號字串。當您需要將字串陣列 （或任何其他資料類型） 轉換為單一串連字串時，此函數非常有用。這在您想要以單一格式化字串呈現一系列值的情況下很有用，例如用於顯示目的或用於進一步處理。

## 語法
<a name="array_join-syntax"></a>

```
array_join(array, delimiter[, nullReplacement])
```

## 引數
<a name="array_join-arguments"></a>

 *陣列*  
任何 ARRAY 類型，但其元素會解譯為字串。

 *delimiter*  
用來分隔串連陣列元素的 STRING。

 *nullReplacement*  
用於在結果中表達 NULL 值的 STRING。

## 傳回類型
<a name="array_join-return-type"></a>

ARRAY\$1JOIN 函數會傳回 STRING，其中陣列元素以分隔符號分隔，而 null 元素會替換為 `nullReplacement`。如果省略 `nullReplacement` ，則會篩選掉`null`元素。如果任何引數為 `NULL`，則結果為 `NULL`。

## 範例
<a name="array_join-example"></a>

在此範例中，ARRAY\$1JOIN 函數採用陣列`['hello', 'world']`，並使用分隔符號 `' '`（空格字元） 聯結元素。產生的輸出是字串 `'hello world'`。

```
SELECT array_join(array('hello', 'world'), ' ');
 hello world
```

在此範例中，ARRAY\$1JOIN 函數採用陣列`['hello', null, 'world']`，並使用分隔符號 `' '`（空格字元） 聯結元素。該`null`值會以提供的取代字串 `','`（逗號） 取代。產生的輸出是字串 `'hello , world'`。

```
SELECT array_join(array('hello', null ,'world'), ' ', ',');
 hello , world
```