Gecko [ www.finalhopeacademy.com ]

Name	Size	Permission
abs.rst	247 B	-rw-r--r--
batch.rst	1013 B	-rw-r--r--
capitalize.rst	233 B	-rw-r--r--
convert_encoding.rst	634 B	-rw-r--r--
date.rst	2.53 KB	-rw-r--r--
date_modify.rst	547 B	-rw-r--r--
default.rst	858 B	-rw-r--r--
escape.rst	3.09 KB	-rw-r--r--
first.rst	443 B	-rw-r--r--
format.rst	392 B	-rw-r--r--
index.rst	402 B	-rw-r--r--
join.rst	429 B	-rw-r--r--
json_encode.rst	485 B	-rw-r--r--
keys.rst	219 B	-rw-r--r--
last.rst	436 B	-rw-r--r--
length.rst	584 B	-rw-r--r--
lower.rst	152 B	-rw-r--r--
merge.rst	1.33 KB	-rw-r--r--
nl2br.rst	358 B	-rw-r--r--
number_format.rst	1.13 KB	-rw-r--r--
raw.rst	1.18 KB	-rw-r--r--
replace.rst	420 B	-rw-r--r--
reverse.rst	989 B	-rw-r--r--
round.rst	784 B	-rw-r--r--
slice.rst	2.07 KB	-rw-r--r--
sort.rst	344 B	-rw-r--r--
split.rst	1.31 KB	-rw-r--r--
striptags.rst	594 B	-rw-r--r--
title.rst	255 B	-rw-r--r--
trim.rst	873 B	-rw-r--r--
upper.rst	152 B	-rw-r--r--
url_encode.rst	527 B	-rw-r--r--

Name

Size

Permission

Action

abs.rst

247 B

-rw-r--r--

batch.rst

1013 B

-rw-r--r--

capitalize.rst

233 B

-rw-r--r--

convert_encoding.rst

634 B

-rw-r--r--

date.rst

2.53 KB

-rw-r--r--

date_modify.rst

547 B

-rw-r--r--

default.rst

858 B

-rw-r--r--

escape.rst

3.09 KB

-rw-r--r--

first.rst

443 B

-rw-r--r--

format.rst

392 B

-rw-r--r--

index.rst

402 B

-rw-r--r--

join.rst

429 B

-rw-r--r--

json_encode.rst

485 B

-rw-r--r--

keys.rst

219 B

-rw-r--r--

last.rst

436 B

-rw-r--r--

length.rst

584 B

-rw-r--r--

lower.rst

152 B

-rw-r--r--

merge.rst

1.33 KB

-rw-r--r--

nl2br.rst

358 B

-rw-r--r--

number_format.rst

1.13 KB

-rw-r--r--

raw.rst

1.18 KB

-rw-r--r--

replace.rst

420 B

-rw-r--r--

reverse.rst

989 B

-rw-r--r--

round.rst

784 B

-rw-r--r--

slice.rst

2.07 KB

-rw-r--r--

sort.rst

344 B

-rw-r--r--

split.rst

1.31 KB

-rw-r--r--

striptags.rst

594 B

-rw-r--r--

title.rst

255 B

-rw-r--r--

trim.rst

873 B

-rw-r--r--

upper.rst

152 B

-rw-r--r--

url_encode.rst

527 B

-rw-r--r--

Code Editor : merge.rst

``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

${this.title}

Code Editor : merge.rst