diff options
Diffstat (limited to 'vendor/twig/twig/doc/filters/first.rst')
-rw-r--r-- | vendor/twig/twig/doc/filters/first.rst | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/vendor/twig/twig/doc/filters/first.rst b/vendor/twig/twig/doc/filters/first.rst new file mode 100644 index 00000000..4295e833 --- /dev/null +++ b/vendor/twig/twig/doc/filters/first.rst | |||
@@ -0,0 +1,25 @@ | |||
1 | ``first`` | ||
2 | ========= | ||
3 | |||
4 | .. versionadded:: 1.12.2 | ||
5 | The first filter was added in Twig 1.12.2. | ||
6 | |||
7 | The ``first`` filter returns the first "element" of a sequence, a mapping, or | ||
8 | a string: | ||
9 | |||
10 | .. code-block:: jinja | ||
11 | |||
12 | {{ [1, 2, 3, 4]|first }} | ||
13 | {# outputs 1 #} | ||
14 | |||
15 | {{ { a: 1, b: 2, c: 3, d: 4 }|first }} | ||
16 | {# outputs 1 #} | ||
17 | |||
18 | {{ '1234'|first }} | ||
19 | {# outputs 1 #} | ||
20 | |||
21 | .. note:: | ||
22 | |||
23 | It also works with objects implementing the `Traversable`_ interface. | ||
24 | |||
25 | .. _`Traversable`: http://php.net/manual/en/class.traversable.php | ||