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

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

# `Fn::Length`
<a name="intrinsic-function-reference-length"></a>

`Fn::Length` 內部函數會傳回陣列或用以傳回陣列的內部函數中的元素數量。

**重要**  
您必須使用 [`AWS::LanguageExtensions` 轉換程序](transform-aws-languageextensions.md) 才能使用 `Fn::Length` 內部函數。

## 宣告
<a name="length-declaration"></a>

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

```
{ "Fn::Length" : IntrinsicFunction }
```

```
{ "Fn::Length" : Array }
```

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

```
Fn::Length : IntrinsicFunction
```

```
Fn::Length : Array
```

## Parameters
<a name="length-parameters"></a>

`IntrinsicFunction`  
此內部函數會傳回要從中傳回多個元素的陣列。

`Array`  
要從中傳回元素數量的陣列。

## 傳回值
<a name="intrinsic-function-reference-length-return"></a>

傳回陣列的內部函數中的元素數量，或傳遞至內部函數的陣列中的元素數量。

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

### 傳回用以傳回陣列的內部函數中的元素數量
<a name="intrinsic-function-reference-length-example-subsection"></a>

此範例程式碼片段會傳回用以傳回陣列的內部函數中的元素數量。該函數會傳回 3。

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

```
{
//...
    "Transform": "AWS::LanguageExtensions"
    //...
        "Fn::Length" : {
            "Fn::Split": ["|", "a|b|c"]
        }
//...
}
```

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

```
Transform: 'AWS::LanguageExtensions'
#...
  Fn::Length: 
    !Split ["|", "a|b|c"]
#...
```

### 傳回參考清單參數類型的 Ref 內部函數中的元素數量
<a name="intrinsic-function-reference-length-example2"></a>

此範例程式碼片段會傳回參考清單參數類型的 `Ref` 內部函數中的元素數量。如果名稱為 `ListParameter` 的參數是一個包含 3 個元素的清單，則函數會傳回 3。

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

```
{
//...
    "Transform": "AWS::LanguageExtensions"
    //...
        "Fn::Length": {
            "Ref": "ListParameter"
        }
//...
}
```

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

```
Transform: 'AWS::LanguageExtensions'
#...
  Fn::Length: 
    !Ref ListParameter
#...
```

### 傳回陣列中的元素數量
<a name="intrinsic-function-reference-length-example3"></a>

此範例程式碼片段會傳回傳遞至內部函數的陣列中的元素數量。該函數會傳回 3。

#### JSON
<a name="intrinsic-function-reference-length-example3.json"></a>

```
 1. {
 2. //...
 3.     "Transform": "AWS::LanguageExtensions"
 4.     //...
 5.         "Fn::Length": [
 6.             1,
 7.             {"Ref": "ParameterName"}, 
 8.             3
 9.         ]
10. //...
11. }
```

#### YAML
<a name="intrinsic-function-reference-legnth-example3.yaml"></a>

```
Transform: 'AWS::LanguageExtensions'
#...
  Fn::Length: 
    - 1
    - !Ref ParameterName
    - 3
#...
```

## 支援的函數
<a name="length-supported-functions"></a>

您可以在 `Fn::Length` 內部函數或陣列中使用下列函數：
+ `Condition Functions`
+ `Fn::Base64`
+ `Fn::FindInMap`
+ `Fn::Join`
+ `Fn::Length`
+ `Fn::Select`
+ `Fn::Split`
+ `Fn::Sub`
+ `Fn::ToJsonString`
+ `Ref`