grouped step matching by field

This block is part of the array group and was last modified in core v12.0.7.

grouped step matching by field v12.0.7

Returns all matching objects for the given key-value pair in groups in steps ([A, A, A, B, B, A, C, C, C] becomes => [(A, A, A), (B, B), (A), (C, C, C)]).

In pins 2
  • array required
    array

    The array of objects to be searched.

  • key required
    value

    The key to be used for matching.

Out pins 1
  • grouped
    array

    An array of groups where each group contains matching objects.

Splits the array into CONSECUTIVE runs: a new group starts each time the key field's value differs from the previous item's, so equal values separated by a different value land in SEPARATE groups. Example: key values [A,A,B,A] -> [[A,A],[B],[A]]. Numbers compare across int/float; an empty input or unwired key outputs an empty grouped array.

A typical wiring for grouped step matching by field: with values feeds the array pin; value feeds the key pin; the grouped out pin feeds length.

Studio canvas example for the grouped step matching by field block: typical wiring for grouped step matching by field.

Version history

Introduced in v12.0.7.


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