Yaffs site version 1.1
[yaffs-website] / vendor / twig / twig / doc / filters / length.rst
diff --git a/vendor/twig/twig/doc/filters/length.rst b/vendor/twig/twig/doc/filters/length.rst
new file mode 100644 (file)
index 0000000..5620f3b
--- /dev/null
@@ -0,0 +1,21 @@
+``length``
+==========
+
+.. versionadded:: 1.33
+
+    Support for the ``__toString()`` magic method has been added in Twig 1.33.
+
+The ``length`` filter returns the number of items of a sequence or mapping, or
+the length of a string.
+
+For objects that implement the ``Countable`` interface, ``length`` will use the
+return value of the ``count()`` method.
+
+For objects that implement the ``__toString()`` magic method (and not ``Countable``),
+it will return the length of the string provided by that method.
+
+.. code-block:: jinja
+
+    {% if users|length > 10 %}
+        ...
+    {% endif %}