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