_n

説明

string _n( string $single, string $plural, int $number [ , string $domain = 'default' ] )
数値フォーマットの翻訳テキストを取得する。

パラメータ

  • $single
    1の場合のパターンを指定。
  • $plural
    1以外の場合のパターンを指定。
  • $number
    数値を指定。
  • $domain
    ドメイン名を指定(省略時は'default')。

返り値

パラメータ$numberを評価し、1の場合は$singleの、1以外の場合は$pluralについて現在のロケールに応じた翻訳テキストを返す。

注意

英語環境などでは数値が1かそれ以外で表現が変わるので、この関数を使って表示パターンを切り替えて表示する。

使用例

  • 変数$ndaysを表示する。
    <?php printf( _n( '%n day', '%n days', $ndays ), $ndays ); ?>
  • 変数$ndaysを独自ドメイン'mytheme'の翻訳情報で表示する。
    <?php printf( _n( '%n day', '%n days', $ndays, 'mytheme' ), $ndays ); ?>

フィルター

数値フォーマットを返す直前に'ngettext'フィルターを呼び出す。パラメータ$translationには翻訳された数値フォーマットが、それ以外のパラメータには本関数が受け取った値が格納される。
return apply_filters( 'ngettext', $translation, $single, $plural, $number, $domain )

アクション

直接実行するアクションはありません。

ソースファイル

/wp-includes/l10n.php

最終更新 : 2019年02月22日 09:30



お勧め

初期化に関連するアクションのおさらい(2013年11月27日 更新)

いつも何気なくfunctions.phpで使っているafter_setup_themeアクションやinitアクション。普段はあまり意識していなかったが、ふとしたことからどんな順番に呼び出されるのか気になってしまい、ちょっと調べてみた。

oEmbed対応サイトを整理した(2017年11月18日 更新)

投稿記事にTwitterやYouTubeのURL(アドレス)を記述したとき、表示されるページにはリンクとしてではなく、埋め込んだURLの内容が表示される。この仕組み(機能)はoEmbedというもので、対応サイトは随時バージョンアップしている。

RSSフィードの抜粋をさらに抜粋(2011年7月21日 更新)

RSSフィードはデフォルトでは「全文(HTMLタグを含む)」になっているが、管理画面の「表示設定」では「抜粋のみ(HTMLタグは除外)」を選択できる。それでも投稿記事が長いと、その抜粋テキストも長くなってしまう。ここではそんなRSSフィードの抜粋テキストを調整する方法を紹介する。

時代はWP_Queryなのか(2011年8月1日 更新)

WordPressのテーマ作成において、メインの投稿記事とは別に特定の条件を指定した投稿内容を表示することが多々ある。つい最近まで get_posts関数を使用することが多かったのだが、最近はWP_Queryクラスを使用することが多くなってきた。

サイトヘルス機能を使ってみた(2019年4月12日 更新)

先月末にWordPress 5.2 Beta1が、今日はWordPress 5.2 Beta2(以降5.2Beta2)が公開された。5.2ではブロックエディターの機能が強化され、サイトの安全性とパフォーマンス向上に役立つとされるサイトヘルス機能が追加される。