Plurals | Localization | 0.7.1-preview
docs.unity3d.com
    Show / Hide Table of Contents

    Plurals

    The PluralFormatter uses language-specific pluralization rules to choose different text for singular and plural forms. Some languages can have as many as 5 different forms.

    Example

    Smart.Format("There {0:plural:is 1 item|are {} items}.", number);
    // outputs "There is 1 item." or "There are 2 items."
    

    Syntax details

    { Number : plural(lang) : singular | plural | more... }

    Number :plural (lang) singular plural more...
    Any Number, like int or double "plural" or "p" or implicit 2-letter language code the singular text the plural text more plural forms
    • English has two plural forms: 1 is singular, everything else is plural. However, some languages have complex rules, with as many as 6 plural forms! Special cases for 0, 2-4, or singular used for 21, 31, etc. So, for these languages, you should specify all plural forms, in smallest-to-largest order (eg. zero|one|two|few|many)
    • The default language rule is english. To use a specific rule, there are 3 ways:
      • Change the default: Smart.Default.GetFormatterExtension<PluralLocalizationFormatter>().DefaultTwoLetterISOLanguageName = "ru";
      • Supply a culture info: Smart.Format(GetCultureInfo("ru"), "{0:банан|банана|бананов}", args...)
      • Specify the (lang) like this: {0:plural(ru):банан|банана|бананов}
    In This Article
    • Example
    • Syntax details
    Back to top
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023