join

This block is part of the array group and was last modified in core v13.0.5.

join v12.0.0 Updated v13.0.5

Creates and returns a new string by concatenating all of the elements in this array, separated by void if none provided

In pins 2
  • array required
    array

    The array of values to join.

  • separator string
    value

    A string to separate each pair of adjacent elements of the array. If none provided, it will join all elements together.

    Default (empty)

Out pins 3
  • value
    value
  • success
    condition
  • error
    value

Joins the text form of every element with the separator from the value in-pin (empty string when unwired) and outputs the result on value with success true. A missing or non-array input outputs null, success false, and INVALID_TYPE on error. Elements of any type are stringified, so objects and arrays join too.

A typical wiring for join: value feeds the value pin; select field values feeds the array pin; the value out pin feeds sha512.

Studio canvas example for the join block: typical wiring for join.

Commonly used with

In production blueprints, this block is most often wired together with:

  • value: feeds into this block. Simply returns the provided value.
  • new object: this block feeds into it. Builds a new object filled with the given fields.
  • select field values: feeds into this block. returns an array with values of the given field in this array of objects.
  • map: feeds into this block. Creates a new array with the results of the provided function on every element in the array.
  • sort array by field: feeds into this block. Sorts the elements of an array by a given key.
  • resize: feeds into this block. resize given images with new dimensions.

Version history

Introduced in v12.0.0.

Last modified in v13.0.5.


Back to array Return to the main group to view all sub-groups Back to array Return to the group to view all blocks within this group