Fn::Length - AWS CloudFormation

Fn::Length

A função intrínseca Fn::Length retorna o número de elementos em uma matriz ou uma função intrínseca que retorna um matriz.

Importante

Você deve usar a transformação AWS::LanguageExtensions para usar a função intrínseca Fn::Length.

Declaração

JSON

{ "Fn::Length" : IntrinsicFunction }
{ "Fn::Length" : Array }

YAML

Fn::Length : IntrinsicFunction
Fn::Length : Array

Parâmetros

IntrinsicFunction

A função intrínseca que retorna uma matriz da qual você deseja retornar vários elementos.

Array

A matriz da qual você deseja retornar o número de elementos.

Valor de retorno

O número de elementos na função intrínseca que retorna uma matriz ou na matriz passada para a função intrínseca.

Exemplos

Retorna o número de elementos em uma função intrínseca que retorna uma matriz

Esse exemplo de trecho retorna o número de elementos em uma função intrínseca que retorna uma matriz. A função retorna 3.

JSON

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

YAML

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

Retorna o número de elementos em uma função intrínseca Ref que referencia um tipo de parâmetro de lista

Esse exemplo de trecho retorna o número de elementos em uma função intrínseca Ref que referencia um tipo de parâmetro de lista. Se o parâmetro com o nome ListParameter for uma lista com 3 elementos, a função retornará 3.

JSON

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

YAML

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

Retornar o número de elementos em uma matriz

Esse exemplo de trecho retorna o número de elementos na matriz passada para a uma função intrínseca. A função retorna 3.

JSON

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

YAML

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

Funções compatíveis

Você pode usar as funções a seguir na função intrínseca Fn::Length ou na matriz:

  • Condition Functions

  • Fn::Base64

  • Fn::FindInMap

  • Fn::Join

  • Fn::Length

  • Fn::Select

  • Fn::Split

  • Fn::Sub

  • Fn::ToJsonString

  • Ref