Fn::Length

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 AWS::Language Extensions pour utiliser la fonction Fn::Length intrinsèque.

Déclaration

JSON

{ "Fn::Length" : IntrinsicFunction }

{ "Fn::Length" : Array }

YAML

Fn::Length : IntrinsicFunction

Fn::Length : Array

Paramètres

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

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

Renvoyer le nombre d'éléments d'une fonction intrinsèque qui renvoie un tableau

Cet exemple d'extrait renvoie le nombre d'éléments d'une fonction intrinsèque qui renvoie un tableau. La fonction renvoie 3.

JSON

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

YAML

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

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

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

YAML

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

Renvoyer le nombre d'éléments d'un tableau

Cet exemple d'extrait renvoie le nombre d'éléments du tableau transmis à la fonction intrinsèque. La fonction renvoie 3.

JSON

{
//...
    "Transform": "AWS::LanguageExtensions"
    //...
        "Fn::Length": [
            1,
            {"Ref": "ParameterName"}, 
            3
        ]
//...
}

YAML

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

Fonctions prises en charge

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