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

Code Editor : slice.rst

``slice``
===========

The ``slice`` filter extracts a slice of a sequence, a mapping, or a string:

.. code-block:: jinja

{% for i in [1, 2, 3, 4, 5]|slice(1, 2) %}
        {# will iterate over 2 and 3 #}
    {% endfor %}

{# outputs 23 #}

You can use any valid expression for both the start and the length:

.. code-block:: jinja

{% for i in [1, 2, 3, 4, 5]|slice(start, length) %}
        {# ... #}
    {% endfor %}

As syntactic sugar, you can also use the ``[]`` notation:

.. code-block:: jinja

{% for i in [1, 2, 3, 4, 5][start:length] %}
        {# ... #}
    {% endfor %}

{{ '12345'[1:2] }} {# will display "23" #}

{# you can omit the first argument -- which is the same as 0 #}
    {{ '12345'[:2] }} {# will display "12" #}

{# you can omit the last argument -- which will select everything till the end #}
    {{ '12345'[2:] }} {# will display "345" #}

The ``slice`` filter works as the `array_slice`_ PHP function for arrays and
`mb_substr`_ for strings with a fallback to `substr`_.

If the start is non-negative, the sequence will start at that start in the
variable. If start is negative, the sequence will start that far from the end
of the variable.

If length is given and is positive, then the sequence will have up to that
many elements in it. If the variable is shorter than the length, then only the
available variable elements will be present. If length is given and is
negative then the sequence will stop that many elements from the end of the
variable. If it is omitted, then the sequence will have everything from offset
up until the end of the variable.

.. note::

It also works with objects implementing the `Traversable`_ interface.

Arguments
---------

* ``start``:         The start of the slice
* ``length``:        The size of the slice
* ``preserve_keys``: Whether to preserve key or not (when the input is an array)

.. _`Traversable`: http://php.net/manual/en/class.traversable.php
.. _`array_slice`: http://php.net/array_slice
.. _`mb_substr` :  http://php.net/mb-substr
.. _`substr`:      http://php.net/substr

${this.title}

Code Editor : slice.rst