function TranslatorInterface::trans

Same name in this branch

11.1.x vendor/php-tuf/composer-stager/src/API/Translation/Service/TranslatorInterface.php \PhpTuf\ComposerStager\API\Translation\Service\TranslatorInterface::trans()
11.1.x core/lib/Drupal/Core/Validation/TranslatorInterface.php \Drupal\Core\Validation\TranslatorInterface::trans()

Translates the given message.

When a number is provided as a parameter named "%count%", the message is parsed for plural forms and a translation is chosen according to this number using the following rules:

Given a message with different plural translations separated by a pipe (|), this method returns the correct portion of the message based on the given number, locale and the pluralization rules in the message itself.

The message supports two different types of pluralization rules:

interval: {0} There are no apples|{1} There is one apple|]1,Inf] There are %count% apples indexed: There is one apple|There are %count% apples

The indexed solution can also contain labels (e.g. one: There is one apple). This is purely for making the translations more clear - it does not affect the functionality.

The two methods can also be mixed: {0} There are no apples|one: There is one apple|more: There are %count% apples

An interval can represent a finite set of numbers: {1,2,3,4}

An interval can represent numbers between two numbers: [1, +Inf] ]-1,2[

The left delimiter can be [ (inclusive) or ] (exclusive). The right delimiter can be [ (exclusive) or ] (inclusive). Beside numbers, you can use -Inf and +Inf for the infinite.

Parameters

string $id The message id (may also be an object that can be cast to string):

array $parameters An array of parameters for the message:

string|null $domain The domain for the message or null to use the default:

string|null $locale The locale or null to use the default:

Throws

\InvalidArgumentException If the locale contains invalid characters

File

vendor/symfony/translation-contracts/TranslatorInterface.php, line 62

Class

TranslatorInterface: @author Fabien Potencier <fabien@symfony.com>

Namespace

Symfony\Contracts\Translation

Code

public function trans(string $id, array $parameters = [], ?string $domain = null, ?string $locale = null) : string;