a Sensio Labs Product

The flexible, fast, and secure
template engine for PHP

Functions » random

Table of Contents

Questions & Feedback

License

Twig documentation is licensed under the new BSD license.

random

New in version 1.5: The random function was added in Twig 1.5.

New in version 1.6: String and integer handling was added in Twig 1.6.

The random function returns a random value depending on the supplied parameter type:

  • a random item from a sequence;
  • a random character from a string;
  • a random integer between 0 and the integer parameter (inclusive).
1
2
3
4
{{ random(['apple', 'orange', 'citrus']) }} {# example output: orange #}
{{ random('ABC') }}                         {# example output: C #}
{{ random() }}                              {# example output: 15386094 (works as the native PHP mt_rand function) #}
{{ random(5) }}                             {# example output: 3 #}

Arguments

  • values: The values
This website is powered by PHP and Twig. The Twig logo is © 2010-2012 Sensio Labs