step matching by field
This block is part of the array group and was last modified in core v12.0.7.
Type Selection Required
This block requires you to select the data type you want to work with. You must manually select the type using the type selector modal. To access the modal, click the white button on the block.
Field Selection Required
This block requires field selection (in). You must manually select the fields you want to work with using the field selector modal. To access the modal, click the white button on the block.
step matching by field v12.0.7 Returns the matching objects for the given key-value pair in steps.
- stop after mismatch required
conditionIf true, only the first contiguous run of matches is returned: scanning stops at the first mismatch AFTER a match. Mismatches before any match do not stop it. Required input pin.
- array required
arrayThe array of objects to be searched. Required input pin.
- key required
valueThe key to be used for matching. Required input pin.
- matches
arrayThe array of objects that have the matching key and value.
- indexes
arrayThe original positions in the input array of each matched item.
- has match
conditionCondition indicating whether there is at least one match.
Selects items whose value at the key path equals the compare pin named after the selected type. Outputs the matches, their original indexes, and condition=true when at least one matched. With stopaftermismatch=true only the FIRST contiguous run of matches is returned: scanning stops at the first mismatch AFTER a match, while mismatches before any match do not stop it. Equality is strict; numbers compare by value across integer/float.
where key |
A typical wiring for step matching by field: == feeds the stopaftermismatch pin; with values feeds the array pin; value feeds the key pin; the array out pin feeds length.
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