Questa è la nuova *Guida di riferimento ai modelli CloudFormation *. Aggiorna i segnalibri e i link. Per informazioni su come iniziare CloudFormation, consulta la [Guida AWS CloudFormation per l'utente](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

La funzione intrinseca `Fn::Length` restituisce il numero di elementi all'interno di una matrice o di una funzione intrinseca che restituisce una matrice.

**Importante**  
È necessario utilizzare [Trasformazione `AWS::LanguageExtensions`](transform-aws-languageextensions.md) per utilizzare la funzione intrinseca `Fn::Length`.

## Dichiarazione
<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 funzione intrinseca che restituisce una matrice della quale desideri restituire il numero di elementi.

`Array`  
La matrice della quale desideri restituire il numero di elementi.

## Valore restituito
<a name="intrinsic-function-reference-length-return"></a>

Il numero di elementi all'interno di una funzione intrinseca che restituisce una matrice o di una matrice passata alla funzione intrinseca. 

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

### Restituire il numero di elementi in una funzione intrinseca che restituisce una matrice
<a name="intrinsic-function-reference-length-example-subsection"></a>

Questo frammento di esempio restituisce il numero di elementi in una funzione intrinseca che restituisce una matrice. La funzione restituisce 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"]
#...
```

### Restituire il numero di elementi in una funzione intrinseca Ref che si riferisce a un tipo di parametro di elenco
<a name="intrinsic-function-reference-length-example2"></a>

Questo frammento di esempio restituisce il numero di elementi in una funzione intrinseca `Ref` che si riferisce a un tipo di parametro di elenco. Se il parametro con il nome `ListParameter` è un elenco con 3 elementi, la funzione restituisce 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
#...
```

### Restituire il numero di elementi in una matrice
<a name="intrinsic-function-reference-length-example3"></a>

Questo frammento di esempio restituisce il numero di elementi nella matrice passata alla funzione intrinseca. La funzione restituisce 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
#...
```

## Funzioni supportate
<a name="length-supported-functions"></a>

Nella matrice o funzione intrinseca `Fn::Length` puoi utilizzare le funzioni seguenti:
+ `Condition Functions`
+ `Fn::Base64`
+ `Fn::FindInMap`
+ `Fn::Join`
+ `Fn::Length`
+ `Fn::Select`
+ `Fn::Split`
+ `Fn::Sub`
+ `Fn::ToJsonString`
+ `Ref`