apply_filters( 'ngettext', string $translation, string $single, string $plural, string $number, string $domain )

Filters the singular or plural form of a string.

Parameters

$translation

(string) Translated text.

$single

(string) The text to be used if the number is singular.

$plural

(string) The text to be used if the number is plural.

$number

(string) The number to compare against to use either the singular or plural form.

$domain

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

More Information

This filter hook is applied to the translated text by the internationalization function that handle plurals (_n()).

IMPORTANT: This filter is always applied even if internationalization is not in effect, and if the text domain has not been loaded. If there are functions hooked to this filter, they will always run. This could lead to a performance problem.

For regular translation functions such as _e(), and for examples on usage, see gettext().

For context-specific translation functions such as _x(), see filter hook gettext_with_context() and ngettext_with_context().

Source

File: wp-includes/l10n.php

View on Trac

Used By

Used By Description
wp-includes/l10n.php: _n()

Translates and retrieves the singular or plural form based on the supplied number.

Changelog

Version Description
2.2.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/hooks/ngettext