ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: home / letacommog / laindinois / OLD / wp-content / plugins / responsive-menu / vendor / twig / twig / doc / filters

``merge``
=========

The ``merge`` filter merges an array with another array:

.. code-block:: jinja

{% set values = [1, 2] %}

{% set values = values|merge(['apple', 'orange']) %}

{# values now contains [1, 2, 'apple', 'orange'] #}

New values are added at the end of the existing ones.

The ``merge`` filter also works on hashes:

.. code-block:: jinja

{% set items = { 'apple': 'fruit', 'orange': 'fruit', 'peugeot': 'unknown' } %}

{% set items = items|merge({ 'peugeot': 'car', 'renault': 'car' }) %}

{# items now contains { 'apple': 'fruit', 'orange': 'fruit', 'peugeot': 'car', 'renault': 'car' } #}

For hashes, the merging process occurs on the keys: if the key does not
already exist, it is added but if the key already exists, its value is
overridden.

.. tip::

If you want to ensure that some values are defined in an array (by given
    default values), reverse the two elements in the call:

.. code-block:: jinja

{% set items = { 'apple': 'fruit', 'orange': 'fruit' } %}

{% set items = { 'apple': 'unknown' }|merge(items) %}

{# items now contains { 'apple': 'fruit', 'orange': 'fruit' } #}
        
.. note::

Internally, Twig uses the PHP `array_merge`_ function. It supports
    Traversable objects by transforming those to arrays.

.. _`array_merge`: http://php.net/array_merge

[+] ..
[-] keys.rst [edit]
[-] striptags.rst [edit]
[-] trim.rst [edit]
[-] spaceless.rst [edit]
[-] join.rst [edit]
[-] date.rst [edit]
[-] index.rst [edit]
[-] capitalize.rst [edit]
[-] escape.rst [edit]
[-] round.rst [edit]
[-] nl2br.rst [edit]
[-] raw.rst [edit]
[-] slice.rst [edit]
[-] number_format.rst [edit]
[-] title.rst [edit]
[-] first.rst [edit]
[-] format.rst [edit]
[-] batch.rst [edit]
[-] sort.rst [edit]
[-] split.rst [edit]
[-] filter.rst [edit]
[-] merge.rst [edit]
[-] length.rst [edit]
[-] map.rst [edit]
[-] upper.rst [edit]
[-] convert_encoding.rst [edit]
[-] lower.rst [edit]
[-] json_encode.rst [edit]
[-] reverse.rst [edit]
[-] reduce.rst [edit]
[-] date_modify.rst [edit]
[-] last.rst [edit]
[-] url_encode.rst [edit]
[-] replace.rst [edit]
[-] abs.rst [edit]
[-] default.rst [edit]