dpolac / twig-only-once
Twig test which returns true only once per value.
v1.0.0
2016-04-30 15:45 UTC
Requires
- php: >=5.3.0
- ext-spl: *
- twig/twig: ~1.0
Requires (Dev)
- phpunit/phpunit: ~5.0
This package is auto-updated.
Last update: 2024-10-29 03:09:49 UTC
README
Twig test which returns true only once per value.
Made to aid in looping through unique values.
{% for article in articles if article.category is onlyOnce %} * {{ article.category }} {% endfor %}
Installation
- Install via Composer:
composer require dpolac/twig-only-once
- Add the extension to Twig:
$twig->addExtension(new \DPolac\OnlyOnce\OnlyOnceExtension());
Usage
Extension provides two tests onlyOnce
and onlyOnceWhenOccurs
.
###is onlyOnce
{% if value is onlyOnce %} ... {% endif %} {% if value is onlyOnce(space) %} ... {% endif %}
Test returns true only when it's called for the first time with given value
and space
pair.
Arguments
- value: can be value of any type
- number - is converted to string, so
12
and'12'
are treated as same value, - string,
- object - are compared by reference, so
new \stdClass()
andnew \stdClass()
are treated as different value, - array - to arrays are treated as same value when have exactly same key-value set; order of keys in hashes is ignored,
- number - is converted to string, so
- space: can be any string (default:
'default'
)
###is onlyOnceWhenOccurs
{% if value is onlyOnceWhenOccurs(n) %} ... {% endif %} {% if value is onlyOnceWhenOccurs(n, space) %} ... {% endif %}
Test returns true only when it's called for the n-th time with given value
and space
pair.
Note that onlyOnce
is an alias to onlyOnceWhenOccurs(1)
, so they share internal occurrences' counter.
Arguments
- value: as in
onlyOnce
, - n: number of occurrences after which test returns true,
- space: can be any string (default:
'default'
).
Examples
Check tests in ./Tests/Fixtures/
directory for more examples.