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 Description

Used when you want to use a translatable plural string once the number is known.


$message = _n_noop( '%s post', '%s posts', 'text-domain' );
printf( translate_nooped_plural( $message, $count, 'text-domain' ), number_format_i18n( $count ) );

Parameters Parameters


(array) (Required) Array with singular, plural, and context keys, usually the result of _n_noop() or _nx_noop().


(int) (Required) Number of objects.


(string) (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 value: 'default'

Top ↑

Return Return

(string) Either $single or $plural translated text.

Top ↑

Source 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 );

Top ↑

Changelog Changelog

Version Description
3.1.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.