Il s’agit du nouveau *Guide de référence des modèles CloudFormation *. Veuillez mettre à jour vos favoris et vos liens. Pour obtenir de l'aide pour démarrer CloudFormation, consultez le [guide de AWS CloudFormation l'utilisateur](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

La fonction intrinsèque `Fn::Length` renvoie le nombre d'éléments d'un tableau ou d'une fonction intrinsèque qui renvoie un tableau.

**Important**  
Vous devez utiliser la transformation [Transformation `AWS::LanguageExtensions`](transform-aws-languageextensions.md) pour utiliser la fonction intrinsèque `Fn::Length`.

## Déclaration
<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`  
La fonction intrinsèque qui renvoie un tableau dont vous voulez renvoyer plusieurs éléments.

`Array`  
Le tableau à partir duquel vous souhaitez renvoyer le nombre d'éléments.

## Valeur renvoyée
<a name="intrinsic-function-reference-length-return"></a>

Le nombre d'éléments de la fonction intrinsèque qui renvoie un tableau ou le nombre d'éléments du tableau transmis à la fonction intrinsèque. 

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

### Renvoyer le nombre d'éléments d'une fonction intrinsèque qui renvoie un tableau
<a name="intrinsic-function-reference-length-example-subsection"></a>

Cet exemple d'extrait renvoie le nombre d'éléments d'une fonction intrinsèque qui renvoie un tableau. La fonction renvoie 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"]
#...
```

### Renvoyer le nombre d'éléments d'une fonction intrinsèque Ref qui fait référence à un type de paramètre de liste
<a name="intrinsic-function-reference-length-example2"></a>

Cet exemple renvoie le nombre d'éléments d'une fonction intrinsèque `Ref` qui fait référence à un paramètre de type liste. Si le paramètre avec le nom `ListParameter` est une liste avec 3 éléments, la fonction renvoie 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
#...
```

### Renvoyer le nombre d'éléments d'un tableau
<a name="intrinsic-function-reference-length-example3"></a>

Cet exemple d'extrait renvoie le nombre d'éléments du tableau transmis à la fonction intrinsèque. La fonction renvoie 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
#...
```

## Fonctions prises en charge
<a name="length-supported-functions"></a>

Vous pouvez utiliser les fonctions suivantes dans la fonction intrinsèque `Fn::Length` ou le tableau :
+ `Condition Functions`
+ `Fn::Base64`
+ `Fn::FindInMap`
+ `Fn::Join`
+ `Fn::Length`
+ `Fn::Select`
+ `Fn::Split`
+ `Fn::Sub`
+ `Fn::ToJsonString`
+ `Ref`