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

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

# `Fn::Split`
<a name="intrinsic-function-reference-split"></a>

若要將字串分割為字串值的清單，讓您可以從產生的字串清單中選取元素，請使用 `Fn::Split` 內部函數。以分隔符號指定分割的位置，例如 `,` (逗號)。在您分割一個字串之後，請使用 [`Fn::Select`](intrinsic-function-reference-select.md) 函數提取特定元素。

例如，如果以逗號分隔的子網路 ID 字串匯入至您的堆疊範本，您可以在每個逗號處分割字串。從子網路 ID 清單，使用 `Fn::Select` 內部函數指定資源的子網路 ID。

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

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

```
{ "Fn::Split" : [ "delimiter", "source string" ] }
```

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

完整函式名稱的語法：

```
Fn::Split: [ delimiter, source string ]
```

短格式的語法：

```
!Split [ delimiter, source string ]
```

## Parameters
<a name="w2aac24c62b9"></a>

您必須同時指定兩個參數。

分隔符號  
字串值，決定來源字串分割的位置。

來源字串  
要分割的字串值。

## 傳回值
<a name="w2aac24c62c11"></a>

字串值清單。

## 範例
<a name="w2aac24c62c13"></a>

以下範例將示範 `Fn::Split` 函數的行為。

### 簡單清單
<a name="w2aac24c62c13b5"></a>

以下範例將在每個垂直線 (`|`) 分割字串。函數傳回 `["a", "b", "c"]`。

#### JSON
<a name="intrinsic-function-reference-split-example.json"></a>

```
{ "Fn::Split" : [ "|" , "a|b|c" ] }
```

#### YAML
<a name="intrinsic-function-reference-split-example.yaml"></a>

```
!Split [ "|" , "a|b|c" ]
```

 

### 包含空字串值的清單
<a name="w2aac24c62c13b7"></a>

如果您以連續分隔符號分割字串，產生的清單將包含空白字串。以下範例顯示包含兩個連續分隔符號與一個附加分隔符號的字串如何進行分割。函數傳回 `["a", "", "c", ""]`。

#### JSON
<a name="w2aac24c62c13b7b5"></a>

```
{ "Fn::Split" : [ "|" , "a||c|" ] }
```

#### YAML
<a name="w2aac24c62c13b7b7"></a>

```
!Split [ "|" , "a||c|" ]
```

 

### 分割匯入的輸出值
<a name="w2aac24c62c13b9"></a>

以下範例將匯入的輸出值進行分割，然後從產生的子網路 ID 清單中選取第三個元素，如 `Fn::Select` 函數所指定。

#### JSON
<a name="w2aac24c62c13b9b5"></a>

```
{ "Fn::Select" : [ "2", { "Fn::Split": [",", {"Fn::ImportValue": "AccountSubnetIDs"}]}] }
```

#### YAML
<a name="w2aac24c62c13b9b7"></a>

```
!Select [2, !Split [",", !ImportValue AccountSubnetIDs]]
```

## 支援的函數
<a name="w2aac24c62c15"></a>

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

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