Fn::Length

La función Fn::Length intrínseca devuelve el número de elementos de una matriz o una función intrínseca que devuelve una matriz.

importante

Debe usar la transformación AWS::LanguageExtensions para poder usar la función Fn::Length intrínseca.

Declaración

JSON

{ "Fn::Length" : IntrinsicFunction }

{ "Fn::Length" : Array }

YAML

Fn::Length : IntrinsicFunction

Fn::Length : Array

Parámetros

IntrinsicFunction

La función intrínseca que devuelve una matriz de la que quiere devolver cierta cantidad de elementos.

Array

La matriz de la que quiere devolver el número de elementos.

Valor devuelto

El número de elementos en la función intrínseca que devuelve una matriz o en la matriz que se pasó a la función intrínseca.

Ejemplos

Devolución del número de elementos en una función intrínseca que devuelve una matriz

En este fragmento de código de ejemplo, se devuelve el número de elementos en una función intrínseca que devuelve una matriz. La función devuelve 3.

JSON

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

YAML

Transform: 'AWS::LanguageExtensions'
#...
  Fn::Length: 
    !Split ["|", "a|b|c"]
#...

Devolución del número de elementos en una función Ref intrínseca que hace referencia a un tipo de parámetro de lista

En este fragmento de código de ejemplo, se devuelve el número de elementos en una función Ref intrínseca que hace referencia a un tipo de parámetro de lista. Si el parámetro con el nombre ListParameter es una lista con 3 elementos, la función devuelve 3.

JSON

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

YAML

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

Devolución de la cantidad de elementos en una matriz

En este fragmento de código de ejemplo se devuelve el número de elementos en una matriz que se pasó a una función intrínseca. La función devuelve 3.

JSON

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

YAML

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

Funciones compatibles

Puede usar las siguientes funciones en la función Fn::Length intrínseca o la matriz:

• Condition Functions

• Fn::Base64

• Fn::FindInMap

• Fn::Join

• Fn::Length

• Fn::Select

• Fn::Split

• Fn::Sub

• Fn::ToJsonString

• Ref