_n_noop() WordPress Function

The nnoop() function is a utility function that allows you to create a null object. This can be useful when you want to create an object that you can later check if it exists.

_n_noop( string $singular, string $plural, string $domain = null ) #

Registers plural strings in POT file, but does not translate them.


Description

Used when you want to keep structures with translatable plural strings and use them later when 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 ) );

Top ↑

Parameters

$singular

(string)(Required)Singular form to be localized.

$plural

(string)(Required)Plural form to be localized.

$domain

(string)(Optional) Text domain. Unique identifier for retrieving translated strings.

Default value: null


Top ↑

Return

(array) Array of translation information for the strings.

  • (string) Singular form to be localized. No longer used.
  • '1'
    (string) Plural form to be localized. No longer used.
  • 'singular'
    (string) Singular form to be localized.
  • 'plural'
    (string) Plural form to be localized.
  • 'context'
    (null) Context information for the translators.
  • 'domain'
    (string) Text domain.


Top ↑

Source

File: wp-includes/l10n.php

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


Top ↑

Changelog

Changelog
VersionDescription
2.5.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.