Fn::Length - AWS CloudFormation
宣告參數傳回值範例支援的函數

這是新的 AWS CloudFormation 範本參考指南。請更新您的書籤和連結。如需開始使用 CloudFormation 的說明，請參閱 AWS CloudFormation 使用者指南。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Fn::Length

Fn::Length 內部函數會傳回陣列或用以傳回陣列的內部函數中的元素數量。

重要

您必須使用 AWS::LanguageExtensions 轉換程序 才能使用 Fn::Length 內部函數。

宣告

JSON

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

YAML

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

參數

IntrinsicFunction

此內部函數會傳回要從中傳回多個元素的陣列。

Array

要從中傳回元素數量的陣列。

傳回值

傳回陣列的內部函數中的元素數量，或傳遞至內部函數的陣列中的元素數量。

範例

傳回用以傳回陣列的內部函數中的元素數量

此範例程式碼片段會傳回用以傳回陣列的內部函數中的元素數量。該函數會傳回 3。

JSON

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

YAML

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

傳回參考清單參數類型的 Ref 內部函數中的元素數量

此範例程式碼片段會傳回參考清單參數類型的 Ref 內部函數中的元素數量。如果名稱為 ListParameter 的參數是一個包含 3 個元素的清單，則函數會傳回 3。

JSON

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

YAML

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

傳回陣列中的元素數量

此範例程式碼片段會傳回傳遞至內部函數的陣列中的元素數量。該函數會傳回 3。

JSON

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

YAML

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

支援的函數

您可以在 Fn::Length 內部函數或陣列中使用下列函數：

  • Condition Functions

  • Fn::Base64

  • Fn::FindInMap

  • Fn::Join

  • Fn::Length

  • Fn::Select

  • Fn::Split

  • Fn::Sub

  • Fn::ToJsonString

  • Ref