``first``
=========
.. versionadded:: 1.12.2
The ``first`` filter was added in Twig 1.12.2.
The ``first`` filter returns the first "element" of a sequence, a mapping, or
a string:
.. code-block:: twig
{{ [1, 2, 3, 4]|first }}
{# outputs 1 #}
{{ { a: 1, b: 2, c: 3, d: 4 }|first }}
{# outputs 1 #}
{{ '1234'|first }}
{# outputs 1 #}
.. note::
It also works with objects implementing the `Traversable`_ interface.
.. _`Traversable`: https://secure.php.net/manual/en/class.traversable.php
| Name | Type | Size | Permission | Actions |
|---|---|---|---|---|
| abs.rst | File | 254 B | 0644 |
|
| batch.rst | File | 1.11 KB | 0644 |
|
| capitalize.rst | File | 232 B | 0644 |
|
| column.rst | File | 555 B | 0644 |
|
| convert_encoding.rst | File | 776 B | 0644 |
|
| country_name.rst | File | 936 B | 0644 |
|
| currency_name.rst | File | 995 B | 0644 |
|
| currency_symbol.rst | File | 989 B | 0644 |
|
| data_uri.rst | File | 1.3 KB | 0644 |
|
| date.rst | File | 3.09 KB | 0644 |
|
| date_modify.rst | File | 629 B | 0644 |
|
| default.rst | File | 856 B | 0644 |
|
| escape.rst | File | 3.75 KB | 0644 |
|
| filter.rst | File | 1.24 KB | 0644 |
|
| first.rst | File | 527 B | 0644 |
|
| format.rst | File | 395 B | 0644 |
|
| format_currency.rst | File | 1.75 KB | 0644 |
|
| format_date.rst | File | 821 B | 0644 |
|
| format_datetime.rst | File | 1.95 KB | 0644 |
|
| format_number.rst | File | 2.6 KB | 0644 |
|
| format_time.rst | File | 821 B | 0644 |
|
| html_to_markdown.rst | File | 1.77 KB | 0644 |
|
| index.rst | File | 446 B | 0644 |
|
| inky_to_html.rst | File | 987 B | 0644 |
|
| inline_css.rst | File | 1.62 KB | 0644 |
|
| join.rst | File | 787 B | 0644 |
|
| json_encode.rst | File | 655 B | 0644 |
|
| keys.rst | File | 218 B | 0644 |
|
| language_name.rst | File | 1003 B | 0644 |
|
| last.rst | File | 519 B | 0644 |
|
| length.rst | File | 723 B | 0644 |
|
| locale_name.rst | File | 985 B | 0644 |
|
| lower.rst | File | 151 B | 0644 |
|
| map.rst | File | 891 B | 0644 |
|
| markdown_to_html.rst | File | 1.67 KB | 0644 |
|
| merge.rst | File | 1.34 KB | 0644 |
|
| nl2br.rst | File | 428 B | 0644 |
|
| number_format.rst | File | 1.59 KB | 0644 |
|
| raw.rst | File | 1.25 KB | 0644 |
|
| reduce.rst | File | 822 B | 0644 |
|
| replace.rst | File | 608 B | 0644 |
|
| reverse.rst | File | 1.04 KB | 0644 |
|
| round.rst | File | 860 B | 0644 |
|
| slice.rst | File | 2.17 KB | 0644 |
|
| sort.rst | File | 351 B | 0644 |
|
| spaceless.rst | File | 1.81 KB | 0644 |
|
| split.rst | File | 1.39 KB | 0644 |
|
| striptags.rst | File | 600 B | 0644 |
|
| timezone_name.rst | File | 1.08 KB | 0644 |
|
| title.rst | File | 254 B | 0644 |
|
| trim.rst | File | 1.02 KB | 0644 |
|
| u.rst | File | 1.61 KB | 0644 |
|
| upper.rst | File | 151 B | 0644 |
|
| url_encode.rst | File | 1.08 KB | 0644 |
|