Dies ist das neue *CloudFormation Template Reference Guide*. Bitte aktualisieren Sie Ihre Lesezeichen und Links. Hilfe zu den ersten CloudFormation Schritten finden Sie im [AWS CloudFormation Benutzerhandbuch](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

Die intrinsische Funktion `Fn::Length` gibt die Anzahl der Elemente innerhalb eines Arrays oder einer intrinsischen Funktion zurück, die ein Array zurückgibt.

**Wichtig**  
Sie müssen die [`AWS::LanguageExtensions`-Transformation](transform-aws-languageextensions.md) verwenden, um die intrinsische Funktion `Fn::Length` nutzen zu können.

## Deklaration
<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`  
Die intrinsische Funktion, die ein Array zurückgibt, aus dem Sie eine Anzahl an Elementen zurückgeben möchten.

`Array`  
Das Array, aus dem Sie die Anzahl an Elementen zurückgeben möchten.

## Rückgabewert
<a name="intrinsic-function-reference-length-return"></a>

Die Anzahl der Elemente innerhalb der intrinsischen Funktion, die ein Array zurückgibt oder des Arrays, das der intrinsischen Funktion übergeben wurde. 

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

### Die Anzahl der Elemente innerhalb einer intrinsischen Funktion zurückgeben, die ein Array zurückgibt.
<a name="intrinsic-function-reference-length-example-subsection"></a>

In diesem Beispiel wird die Anzahl der Elemente innerhalb einer intrinsischen Funktion zurückgegeben, die ein Array zurückgibt. Die Funktion gibt den Wert „3“ zurück.

#### 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"]
#...
```

### Zurückgeben der Anzahl der Elemente innerhalb einer intrinsischen Ref-Funktion, die auf einen Listenparametertyp verweist
<a name="intrinsic-function-reference-length-example2"></a>

In diesem Beispiel wird die Anzahl der Elemente innerhalb der intrinsischen Funktion `Ref` zurückgeben, die auf einen Listenparametertyp verweist. Wenn der Parameter mit dem Namen `ListParameter` eine Liste mit 3 Elementen ist, gibt die Funktion 3 zurück.

#### 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
#...
```

### Zurückgeben der Anzahl von Elementen innerhalb eines Arrays
<a name="intrinsic-function-reference-length-example3"></a>

In diesem Beispiel wird die Anzahl der Elemente innerhalb eines Arrays zurückgegeben, das der intrinsischen Funktion übergeben wurde. Die Funktion gibt den Wert „3“ zurück.

#### 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
#...
```

## Unterstützte Funktionen
<a name="length-supported-functions"></a>

Sie können die folgenden Funktionen in der intrinsischen Funktion `Fn::Length` oder im Array verwenden:
+ `Condition Functions`
+ `Fn::Base64`
+ `Fn::FindInMap`
+ `Fn::Join`
+ `Fn::Length`
+ `Fn::Select`
+ `Fn::Split`
+ `Fn::Sub`
+ `Fn::ToJsonString`
+ `Ref`