_n( string $single, string $plural, int $number, string $domain = 'default' )

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

Contents

Description Description

Used when you want to use the appropriate form of a string based on whether a number is singular or plural.

Example:

printf( _n( '%s person', '%s people', $count, 'text-domain' ), number_format_i18n( $count ) );

Parameters Parameters

$single

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

$plural

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

$number

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

$domain

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

Default value: 'default'

Top ↑

Return Return

(string) The translated singular or plural form.

Top ↑

Source Source

File: wp-includes/l10n.php 

function _n( $single, $plural, $number, $domain = 'default' ) {
	$translations = get_translations_for_domain( $domain );
	$translation  = $translations->translate_plural( $single, $plural, $number );

	/**
	 * Filters the singular or plural form of a string.
	 *
	 * @since 2.2.0
	 *
	 * @param string $translation Translated text.
	 * @param string $single      The text to be used if the number is singular.
	 * @param string $plural      The text to be used if the number is plural.
	 * @param string $number      The number to compare against to use either the singular or plural form.
	 * @param string $domain      Text domain. Unique identifier for retrieving translated strings.
	 */
	return apply_filters( 'ngettext', $translation, $single, $plural, $number, $domain );
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
2.8.0 Introduced.

Top ↑

Top ↑

Used By Used By

Used By
Used By Description
wp-includes/functions.php: human_readable_duration()

Convert a duration to human readable format.
wp-admin/includes/user.php: WP_Privacy_Requests_Table::process_bulk_action()

Process bulk actions.
wp-includes/widgets/class-wp-widget-custom-html.php: WP_Widget_Custom_HTML::enqueue_admin_scripts()

Loads the required scripts and styles for the widget control.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::save_changeset_post()

Save the post for the loaded changeset.
wp-includes/embed.php: print_embed_comments_button()

Prints the necessary markup for the embed comments button.
wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::enqueue_scripts()

Enqueue scripts and styles for Customizer pane.
wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::customize_register()

Add the customizer settings and controls.
wp-includes/comment-template.php: get_comments_number_text()

Display the language string for the number of comments the current post has.
wp-admin/includes/class-wp-ms-users-list-table.php: WP_MS_Users_List_Table::get_views()
wp-admin/includes/class-wp-screen.php: WP_Screen::render_screen_layout()

Render the option for number of columns on the page
wp-admin/includes/class-wp-plugins-list-table.php: WP_Plugins_List_Table::get_views()
wp-admin/includes/class-wp-list-table.php: WP_List_Table::ajax_response()

Handle an incoming ajax request (called from admin-ajax.php)
wp-admin/includes/class-wp-list-table.php: WP_List_Table::comments_bubble()

Display a comment count bubble
wp-admin/includes/class-wp-list-table.php: WP_List_Table::pagination()

Display the pagination.
wp-admin/includes/class-wp-ms-themes-list-table.php: WP_MS_Themes_List_Table::get_views()
wp-admin/includes/plugin-install.php: install_plugin_information()

Display plugin information in dialog box form.
wp-admin/includes/dashboard.php: wp_dashboard_right_now()

Dashboard widget that displays some basic stats about the site.
wp-admin/includes/dashboard.php: wp_network_dashboard_right_now()
wp-admin/includes/template.php: wp_star_rating()

Output a HTML element with a star rating for a given rating.
wp-admin/includes/class-wp-users-list-table.php: WP_Users_List_Table::single_row()

Generate HTML for a single row on the users.php admin panel.
wp-admin/includes/ajax-actions.php: _wp_ajax_delete_comment_response()

Sends back current comment total and new page links if they need to be updated.
wp-admin/includes/ajax-actions.php: wp_ajax_replyto_comment()

Ajax handler for replying to a comment.
wp-includes/l10n.php: translate_nooped_plural()

Translates and retrieves the singular or plural form of a string that’s been registered with _n_noop() or _nx_noop().
wp-includes/formatting.php: human_time_diff()

Determines the difference between two timestamps.
wp-includes/pluggable.php: wp_notify_moderator()

Notifies the moderator of the site about a new comment that is awaiting approval.
wp-includes/deprecated.php: _nc()

Legacy version of _n(), which supports contexts.
wp-includes/update.php: wp_get_update_data()

Collect counts and UI strings for available updates
wp-includes/admin-bar.php: wp_admin_bar_comments_menu()

Add edit comments link with awaiting moderation count bubble.
wp-includes/ms-functions.php: wpmu_validate_blog_signup()

Processes new site registrations.
wp-includes/comment-template.php: comments_popup_link()

Displays the link to the comments for the current post ID.
wp-includes/class-wp-customize-widgets.php: WP_Customize_Widgets::enqueue_scripts()

Enqueues scripts and styles for Customizer panel and export data to JavaScript.
wp-includes/script-loader.php: wp_default_scripts()

Register all WordPress scripts.
Show 27 more used by Hide more used by

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note
    Contributed by Codex —

    Display either “1 star” or “x stars” for a star rating plugin.

    $rating = '3';

$text = sprintf( _n( '%s star', '%s stars', $rating, 'wpdocs_textdomain' ), $rating );

// "3 stars"
echo $text;

    Important: Never do a calculation inside the sprintf() function! The following won’t work:

    $text = sprintf( 
	_n( '%s star', '%s stars', $rating, 'wpdocs_textdomain' ), 
	2 <= $rating ? $rating -1 : $rating
);
  2. Skip to note 2 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
    Contributed by Felipe Elia —

    As explained by @sergeybiryukov here, here, here and here, this functions should NOT be use in one item or more than one item scenarios, but for singular form and plural forms, which is not the same thing. Also both strings should have placeholders.

    As he stated:

    In languages that have complex plural structures the singular form can be used for numbers other than 1, so if the goal is to display a string for exactly 1 item, an explicit check like 

    1 === count( $items )

    should be used instead of 

    _n()

    This problem is also covered in Codex.

    Although it would be possible address this issue changing the plural form for Russian and other slavic languages it would bring a too big effort as explained here.

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