$$join

Joins an array of input as strings with an optional delimiter (default is ""), prefix and suffix. null values are omitted

Usage

{ 
  "$$join": /* Array of elements */,
  "delimiter": "" /* string */,
  "prefix": "" /* string */,
  "suffix": "" /* string */,
  "keep_nulls": false /* boolean */
}

"$$join([delimiter],[prefix],[suffix],[keep_nulls]):{input}"

note

Concrete values in the usage example are default values.

Returns

string

Arguments

Argument	Type	Values	Required / Default Value	Description
Primary	array		Yes	Array of elements
delimiter	string		""	Delimiter to join any 2 adjacent elements
prefix	string		""	A string to prefix the result
keep_nulls	boolean	false/true	false	Whether to keep null values when joining
suffix	string		""	A string to suffix the result

Examples

Input

Definition

Output

[
  "a",
  "b",
  "c"
]

{
  "$$join": "$"
}

"abc"

Test

[
  "a",
  "b",
  "c"
]

{
  "$$join": [
    "$[0]",
    "B"
  ]
}

"aB"

Test

[
  "a",
  "b",
  "c"
]

{
  "$$join": [
    "$[0]",
    null,
    null,
    "B"
  ],
  "delimiter": ","
}

"a,B"

Test

[
  "a",
  "b",
  "c"
]

{
  "$$join": "$",
  "$$delimiter": ","
}

"a,b,c"

Test

[
  "hello",
  "world"
]

{
  "$$join": "$",
  "delimiter": " ",
  "prefix": "<"
}

"<hello world"

Test

[
  "hello",
  "world"
]

{
  "$$join": "$",
  "delimiter": " ",
  "prefix": "<",
  "suffix": ">"
}

"<hello world>"

Test

[
  "hello",
  " ",
  "world"
]

"$$join:$"

"hello world"

Test

[
  "hello",
  " ",
  "world"
]

"$$join():$"

"hello world"

Test

[
  "hello",
  5,
  true
]

"$$join:$"

"hello5true"

Test

[
  "hello",
  " ",
  "world"
]

"$$join:$"

"hello world"

Test

[
  "hello",
  " ",
  "world"
]

"$$join:$"

"hello world"

Test

[
  "hello",
  null,
  "world"
]

"$$join(' '):$"

"hello world"

Test

[
  "hello",
  null,
  "world"
]

"$$join(' ',,,true):$"

"hello null world"

Test

[
  "hello",
  " ",
  "world"
]

"$$join(,):$"

"hello world"

Test

[
  "hello",
  " ",
  "world"
]

"$$join(:):$"

"hello: :world"

Test

[
  "hello",
  " ",
  "world"
]

"$$join(','):$"

"hello, ,world"

Test

[
  "hello",
  " ",
  "world"
]

"$$join('\\''):$"

"hello' 'world"

Test

[
  "hello",
  " ",
  "world"
]

"$$join('$[1]'):$"

"hello   world"

Test

[
  "hello",
  "world"
]

"$$join( ,<):$"

"<hello world"

Test

[
  "hello",
  "world"
]

"$$join( ,<,>):$"

"<hello world>"

Test