join

The join function concatenates multiple values into a single string, inserting a delimiter between each value.

It is useful for turning arrays or multiple values into a delimited string (for example, CSV-style output).

Syntax

join(delimiter, values...)

or as a chained function:

<array>.join(delimiter)

Arguments

• delimiter (string)
  The string to insert between each value.
• values (string | array[string])
  The values to join. These can be provided as:
  • Multiple arguments
  • A single array
  • A chained array input

Examples

Chained array input

["a","b","c"].join(",")

Output:

a,b,c

Variadic arguments

join(",", "a", "b", "c")

Output:

a,b,c

Array argument

join(",", ["a", "b", "c"])

Output:

a,b,c

Notes

• All arguments given to join are expected to be strings. Dasel will not try to convert for you.
• The order of values is preserved.
• This function is commonly used for formatting output for shells, logs, or downstream tools.