i18n functions
##############


.. php:function:: __($message, $default = null)

    Retrieves a translation from the last loaded dictionary.

    :param string $message: The message to translate.
    :param string $default: The default text to return when the message is not found. Default value is the message itself.
    :returns: The translation or ``null`` if not founded

.. php:function:: n__($singular, $plural, $n = false)

    The plural version of :php:func:`__`. Some languages have more than one form for plural messages dependent on the count.

    :param string $singular: The singular form of the string to be converted. Used as the key for the search in the dictionary
    :param string $plural: The plural form
    :param string $n: Used to determine which plural form to used depending locale.
    :returns:
        | The translation or, if not founded, $singular is returned if n == 1, otherwise $plural
        | If third parameter is ommited and translation founded, return an ``array`` of singular and plural forms

.. php:function:: ___($group, $message, $default = null)

    Retrieves a translation from a specific dictionary.

    :param string $group: Which dictionary to look into.
    :param string $message: The message to translate.
    :param string $default: The default text to return when the message is not found. Default value is the message itself.
    :returns: The translation or ``null`` if not founded