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

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

``split``
=========

.. versionadded:: 1.10.3
    The ``split`` filter was added in Twig 1.10.3.

The ``split`` filter splits a string by the given delimiter and returns a list
of strings:

.. code-block:: jinja

{% set foo = "one,two,three"|split(',') %}
    {# foo contains ['one', 'two', 'three'] #}

You can also pass a ``limit`` argument:

* If ``limit`` is positive, the returned array will contain a maximum of
   limit elements with the last element containing the rest of string;

* If ``limit`` is negative, all components except the last -limit are
   returned;

* If ``limit`` is zero, then this is treated as 1.

.. code-block:: jinja

{% set foo = "one,two,three,four,five"|split(',', 3) %}
    {# foo contains ['one', 'two', 'three,four,five'] #}

If the ``delimiter`` is an empty string, then value will be split by equal
chunks. Length is set by the ``limit`` argument (one character by default).

.. code-block:: jinja

{% set foo = "123"|split('') %}
    {# foo contains ['1', '2', '3'] #}

{% set bar = "aabbcc"|split('', 2) %}
    {# bar contains ['aa', 'bb', 'cc'] #}

.. note::

Internally, Twig uses the PHP `explode`_ or `str_split`_ (if delimiter is
    empty) functions for string splitting.

Arguments
---------

* ``delimiter``: The delimiter
* ``limit``:     The limit argument

.. _`explode`:   http://php.net/explode
.. _`str_split`: http://php.net/str_split

[+] ..
[-] 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]