Fn::Length

組み込み関数 Fn::Length は、配列内の要素数を返すか、配列を返す組み込み関数を返します。

重要

Fn::Length 組み込み関数を使用するには AWS::LanguageExtensions 変換を使用する必要があります。

宣言

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