Container Utils
===============

🔗 |Store Page|

.. |Store Page| raw:: html

   <a href="https://www.unrealengine.com/marketplace/en-US/product/container-utils" target="_blank">Store Page</a>

This plugin provides blueprint nodes for common Array utilies such as filtering and transforming. Arrays can be of any type, and if/else logic and type mapping is performed by setting a by-ref values.


Blueprint Nodes
---------------

.. _filterArray:

Filter Array
............

.. image:: /images/filter-array.png

Select items from in input array into a new array, choosing only those items for which the :code:`Select Item` boolean is set to true during the loop.

.. _take:

Take
....

.. image:: /images/take.png

Take :code:`Count` items from the beginning of the input array and copy them to a new array. If :code:`Count` is larger than size of the input array, all items from the input array are selected.


.. _takeWhile:

Take Until
..........

.. image:: /images/take-until.png

Take items from the beginning of the input array and copy them to a new array for as long as the value of the :code:`Break` node is false. Set :code:`Break` to true to stop taking.


.. _drop:

Drop
....

.. image:: /images/drop.png

Drop :code:`Count` items from the beginning of the input array and copy the remaining items to a new array. If :code:`Count` is larger than the size of the input array, no items from the input array are selected.


.. _drop-until:

Drop Until
..........

.. image:: /images/drop-until.png

Drop items from the beginning of the input array for as long as the value of the :code:`Break` node is false. Set :code:`Break` to true to stop dropping and copy the remaining items to a new array.

.. _reduce:

Reduce
......

.. image:: /images/reduce.png

Perform a reduce, or left fold, operation on an input array. Set the reduced value node by reference in the inner loop to perform arbitrary accumulations, filtering, transformations such as casting or other reductions.



.. _map-array:

Map Array
..........

.. image:: /images/map-array.png

Transform each item in the input array to a new value, possibly even a new type, and copy the resulting value into a new array. Set the mapped value by reference.