_nx()
Retrieves the translation of singular or plural form based on the supplied number, with given context.
This is a hybrid of _n() and _x(). It supports context and plurals.
Used when you want to use the appropriate form of a string with context based on whether a number is singular or plural.
Read more about the translation of multiple forms of numbers in the description of _n().
1 time — 0.000041 sec (very fast) | 50000 times — 0.12 sec (very fast) | PHP 7.1.2, WP 4.7.3
Hooks from the function
Return
String
. The translated singular or plural form.
Usage
_nx( $single, $plural, $number, $context, $domain );
- $single(string) (required)
- The text to be used if the number is singular.
- $plural(string) (required)
- The text to be used if the number is plural.
- $number(int) (required)
- The number to compare against to use either the singular or plural form.
- $context(string) (required)
- Context information for the translators.
- $domain(string)
- Text domain. Unique identifier for retrieving translated strings.
Default: 'default'
Examples
#1 Example of a generic phrase which is disambiguated via the context parameter
$people = 5; $animals = 7; printf( _nx( '%s group', '%s groups', $people, 'group of people', 'text-domain' ), $people ) ); printf( _nx( '%s group', '%s groups', $animals, 'group of animals', 'text-domain' ), $animals ) );
Changelog
Since 2.8.0 | Introduced. |
Since 5.5.0 | Introduced ngettext_with_context-{$domain} filter. |