💾 Archived View for cfdocs.wetterberg.nu › intrinsic-function-reference-join.gemini captured on 2023-11-04 at 12:58:03. Gemini links have been rewritten to link to archived content

View Raw

More Information

⬅️ Previous capture (2021-12-03)

-=-=-=-=-=-=-

Fn::Join

Search

The intrinsic function `Fn::Join` appends a set of values into a single value, separated by the specified delimiter. If a delimiter is the empty string, the set of values are concatenated with no delimiter.

Declaration

JSON

{ "Fn::Join" : [ "delimiter", [ comma-delimited list of values ] ] }

YAML

Syntax for the full function name:

Fn::Join: [ delimiter, [ comma-delimited list of values ] ]

Syntax for the short form:

!Join [ delimiter, [ comma-delimited list of values ] ]

Parameters

delimiter

The value you want to occur between fragments. The delimiter will occur between fragments only. It will not terminate the final value.

ListOfValues

The list of values you want combined.

Return value

The combined string.

Examples

Join a simple string array

The following example returns: `"a:b:c"`.

JSON

1. "Fn::Join" : [ ":", [ "a", "b", "c" ] ]

YAML

1. !Join [ ":", [ a, b, c ] ]

Join using the ref function with parameters

The following example uses `Fn::Join` to construct a string value. It uses the `Ref` function with the `AWS::Partition` parameter and the `AWS::AccountId` pseudo parameter.

JSON

 1. {
 2.   "Fn::Join": [
 3.     "", [
 4.       "arn:",
 5.       {
 6.         "Ref": "AWS::Partition"
 7.       },
 8.       ":s3:::elasticbeanstalk-*-",
 9.       {
10.         "Ref": "AWS::AccountId"
11.       }
12.     ]
13.   ]
14. }

YAML

1. !Join
2.   - ''
3.   - - 'arn:'
4.     - !Ref AWS::Partition
5.     - ':s3:::elasticbeanstalk-*-'
6.     - !Ref 'AWS::AccountId'

Also see the Fn::Sub function for similar functionality.

Fn::Sub

Supported functions

For the `Fn::Join` delimiter, you cannot use any functions. You must specify a string value.

For the `Fn::Join` list of values, you can use the following functions: