exclude by value

This block is part of the array group and was last modified in core v13.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.

exclude by value array v12.0.7 Updated v13.0.7

Removes the items equal to the given value. Returns all items that do NOT match.

In pins 1

Array required
array
The array to be filtered.

Out pins 2

Array
array
Array with all items that do NOT match the given value.
error v13.0.7
value
Error message in case of failure.

EXCLUDES every item equal to the value on the type-named comparison pin and returns the rest; it does NOT keep matches. Numbers compare across int/float representations, but numeric strings do NOT equal numbers. Example: [1,2,1] value=1 -> [2]. With the comparison pin unwired the input passes through unchanged; a missing or non-array input emits an empty array and NOT_AN_ARRAY on error.

filter

A typical wiring for exclude by value: select field values feeds the given_array pin; the array out pin feeds remove duplicates.

Commonly used with

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

get fields: feeds into this block. Gets the selected fields from the given object.
set fields: this block feeds into it. Generates an array of mutations based on the given filled fields.
get guid: feeds into this block. Returns the guid (field: _meta.guid) of the given user.
select field values: feeds into this block. returns an array with values of the given field in this array of objects.
flatten: feeds into this block. Accepts a nested array and returns a flattened array.
remove duplicates: this block feeds into it. Removes duplicate values from an array.

Version history

Introduced in v12.0.7.

Last modified in v13.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