這是新的 *CloudFormation 範本參考指南*。請更新您的書籤和連結。如需 CloudFormation 入門的說明，請參閱 [AWS CloudFormation 使用者指南](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)。

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

# `Fn::Join`
<a name="intrinsic-function-reference-join"></a>

透過 `Fn::Join` 內部函數，即可將一組值附加至單一值，並以指定的分隔符號隔開。如果分隔符號是空白字串，系統即會串連這一組值，而不使用分隔符號。

## 宣告
<a name="w2aac24c48b5"></a>

### JSON
<a name="intrinsic-function-reference-join-syntax.json"></a>

```
{ "Fn::Join" : [ "delimiter", [ comma-delimited list of values ] ] }
```

### YAML
<a name="intrinsic-function-reference-join-syntax.yaml"></a>

完整函式名稱的語法：

```
Fn::Join: [ delimiter, [ comma-delimited list of values ] ]
```

短格式的語法：

```
!Join [ delimiter, [ comma-delimited list of values ] ]
```

## Parameters
<a name="intrinsic-function-reference-join-parameters"></a>

分隔符號  
要在片段之間執行的值。分隔符號僅會出現在片段之間，且不會終止最後的值。

ListOfValues  
要合併的數值清單。

## 傳回值
<a name="intrinsic-function-reference-join-returnvalues"></a>

合併的字串。

## 範例
<a name="intrinsic-function-reference-join-examples"></a>

### 聯結簡單的字串陣列
<a name="intrinsic-function-reference-join-example1"></a>

以下範例傳回：`"a:b:c"`。

#### JSON
<a name="intrinsic-function-reference-join-example1.json"></a>

```
"Fn::Join" : [ ":", [ "a", "b", "c" ] ]
```

#### YAML
<a name="intrinsic-function-reference-join-example1.yaml"></a>

```
!Join [ ":", [ a, b, c ] ]
```

### 使用搭配參數的 Ref 函數進行聯結
<a name="intrinsic-function-reference-join-example2"></a>

以下範例會使用 `Fn::Join` 來建構字串值，且將搭配 `Ref` 函數、`AWS::Partition` 參數和 `AWS::AccountId` 虛擬參數一起使用。

#### JSON
<a name="intrinsic-function-reference-join-example2.json"></a>

```
{
  "Fn::Join": [
    "", [
      "arn:",
      {
        "Ref": "AWS::Partition"
      },
      ":s3:::elasticbeanstalk-*-",
      {
        "Ref": "AWS::AccountId"
      }
    ]
  ]
}
```

#### YAML
<a name="intrinsic-function-reference-join-example2.yaml"></a>

```
!Join
  - ''
  - - 'arn:'
    - !Ref AWS::Partition
    - ':s3:::elasticbeanstalk-*-'
    - !Ref AWS::AccountId
```

**注意**  
如需了解類似功能，另請參閱 [`Fn::Sub`](intrinsic-function-reference-sub.md) 函數。

## 支援的函數
<a name="intrinsic-function-reference-join-supportedfunctions"></a>

對於 `Fn::Join` 分隔符號，您不能使用任何函數。您必須指定一個字串值。

對於值的 `Fn::Join` 清單，您可以使用下列函數：
+ `Fn::Base64`
+ `Fn::FindInMap`
+ `Fn::GetAtt`
+ `Fn::GetAZs`
+ `Fn::If`
+ `Fn::ImportValue`
+ `Fn::Join`
+ `Fn::Split`
+ `Fn::Select`
+ `Fn::Sub`
+ `Ref`