40 lines
896 B
ReStructuredText
40 lines
896 B
ReStructuredText
``trim``
|
|
========
|
|
|
|
The ``trim`` filter strips whitespace (or other characters) from the beginning
|
|
and end of a string:
|
|
|
|
.. code-block:: twig
|
|
|
|
{{ ' I like Twig. '|trim }}
|
|
|
|
{# outputs 'I like Twig.' #}
|
|
|
|
{{ ' I like Twig.'|trim('.') }}
|
|
|
|
{# outputs ' I like Twig' #}
|
|
|
|
{{ ' I like Twig. '|trim(side='left') }}
|
|
|
|
{# outputs 'I like Twig. ' #}
|
|
|
|
{{ ' I like Twig. '|trim(' ', 'right') }}
|
|
|
|
{# outputs ' I like Twig.' #}
|
|
|
|
.. note::
|
|
|
|
Internally, Twig uses the PHP `trim`_, `ltrim`_, and `rtrim`_ functions.
|
|
|
|
Arguments
|
|
---------
|
|
|
|
* ``character_mask``: The characters to strip
|
|
|
|
* ``side``: The default is to strip from the left and the right (`both`) sides, but `left`
|
|
and `right` will strip from either the left side or right side only
|
|
|
|
.. _`trim`: https://secure.php.net/trim
|
|
.. _`ltrim`: https://secure.php.net/ltrim
|
|
.. _`rtrim`: https://secure.php.net/rtrim
|