새로운 *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`는 배열을 반환하는 배열 또는 내장 함수 내의 요소 수를 반환합니다.

**중요**  
`Fn::Length` 내장 함수를 사용하려면 [`AWS::LanguageExtensions` 변환](transform-aws-languageextensions.md)를 사용해야 합니다.

## 선언
<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
```

## 파라미터
<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`