_nx_noop() — описание функции WordPress на русском

Сигнатура

_nx_noop( string $singular, string $plural, string $context, string $domain = null ): array

Описание

Используется, когда нужно сохранить структуры с переводимыми строками во множественном числе и использовать их позже, когда число станет известно.
Пример обобщённой фразы, которая уточняется через параметр контекста:
$messages = array(
'people' => _nx_noop( '%s group', '%s groups', 'people', 'text-domain' ),
'animals' => _nx_noop( '%s group', '%s groups', 'animals', 'text-domain' ),
);
...
$message = $messages[ $type ];
printf( translate_nooped_plural( $message, $count, 'text-domain' ), number_format_i18n( $count ) );

Оригинал (английский)

Used when you want to keep structures with translatable plural strings and use them later when the number is known.

Example of a generic phrase which is disambiguated via the context parameter:

$messages = array(
     'people'  => _nx_noop( '%s group', '%s groups', 'people', 'text-domain' ),
     'animals' => _nx_noop( '%s group', '%s groups', 'animals', 'text-domain' ),
);
...
$message = $messages[ $type ];
printf( translate_nooped_plural( $message, $count, 'text-domain' ), number_format_i18n( $count ) );

Параметры

$singular string обязательный

Форма единственного числа для локализации.

$plural string обязательный

Форма множественного числа для локализации.

$context string обязательный

Контекстная информация для переводчиков.

$domain string необязательный = null

Текстовый домен. Уникальный идентификатор для получения переведённых строк.

Возвращаемое значение

array

0 stringФорма единственного числа для локализации. Больше не используется. 1 stringФорма множественного числа для локализации. Больше не используется. 2 stringКонтекстная информация для переводчиков. Больше не используется. singular stringФорма единственного числа для локализации. plural stringФорма множественного числа для локализации. context stringКонтекстная информация для переводчиков. domain string|nullТекстовый домен.

Исходный код

wp-includes/l10n.php:654

function _nx_noop( $singular, $plural, $context, $domain = null ) {
	return array(
		0          => $singular,
		1          => $plural,
		2          => $context,
		'singular' => $singular,
		'plural'   => $plural,
		'context'  => $context,
		'domain'   => $domain,
	);
}

История изменений

Версия	Описание
2.8.0	Introduced.