translate_nooped_plural( array $nooped_plural, int $count, string $domain = 'default' )
Translates and retrieves the singular or plural form of a string that’s been registered with _n_noop() or _nx_noop().
Description
Used when you want to use a translatable plural string once the number is known.
Example:
$message = _n_noop( '%s post', '%s posts', 'text-domain' );
...
printf( translate_nooped_plural( $message, $count, 'text-domain' ), number_format_i18n( $count ) );Parameters
- $nooped_plural
-
(Required) Array with singular, plural, and context keys, usually the result of _n_noop() or _nx_noop().
- $count
-
(Required) Number of objects.
- $domain
-
(Optional) Text domain. Unique identifier for retrieving translated strings. If $nooped_plural contains a text domain passed to _n_noop() or _nx_noop(), it will override this value. Default 'default'.
Default value: 'default'
Return
(string) Either $single or $plural translated text.
Source
File: wp-includes/l10n.php
function translate_nooped_plural( $nooped_plural, $count, $domain = 'default' ) {
if ( $nooped_plural['domain'] )
$domain = $nooped_plural['domain'];
if ( $nooped_plural['context'] )
return _nx( $nooped_plural['singular'], $nooped_plural['plural'], $count, $nooped_plural['context'], $domain );
else
return _n( $nooped_plural['singular'], $nooped_plural['plural'], $count, $domain );
}
Changelog
| Version | Description |
|---|---|
| WP-3.1.0 | Introduced. |