Struct I18nPartial 

pub struct I18nPartial { /* private fields */ }

Represents translations for a single file.

Provides methods to access translated text with support for placeholders, plurals, and gendered translations.

Example

use bevy::prelude::*;
use bevy_intl::I18n;
 
fn display_text(i18n: Res<I18n>) {
    let t = i18n.translation("ui");
     
    // Simple translation
    let greeting = t.t("hello");
     
    // With placeholder
    let welcome = t.t_with_arg("welcome", &[&"John"]);
     
    // Plural form
    let items = t.t_with_plural("item_count", 5);
     
    // Gendered translation
    let title = t.t_with_gender("title", "male");
}

Implementations

impl I18nPartial

pub fn t(&self, key: &str) -> String

Gets a translated string for the given key.

Falls back to the fallback language if the key is not found in the current language.

Arguments

• key - Translation key to look up

Returns

The translated string, or “Missing translation” if not found.

Example

let text = i18n.translation("ui").t("hello");

pub fn t_with_arg(&self, key: &str, args: &[&dyn ToString]) -> String

Gets a translated string with placeholder replacement.

Replaces {{}} placeholders in the translation with the provided arguments.

Arguments

• key - Translation key to look up
• args - Values to replace placeholders with

Returns

The translated string with placeholders replaced.

Example

// JSON: "welcome": "Hello {{name}}!"
let text = i18n.translation("ui").t_with_arg("welcome", &[&"John"]);
// Result: "Hello John!"

pub fn t_with_plural(&self, key: &str, count: usize) -> String

Gets a pluralized translation based on count.

Uses advanced plural rules with fallback priority:

1. Exact count (“0”, “1”, “2”, etc.)
2. ICU categories (“zero”, “one”, “two”, “few”, “many”)
3. Basic fallback (“one” vs “other”)

Arguments

• key - Translation key to look up
• count - Number to determine plural form

Returns

The translated string with count placeholder replaced.

Example

// JSON: "items": { "one": "One item", "many": "{{count}} items" }
let text = i18n.translation("ui").t_with_plural("items", 5);
// Result: "5 items"

pub fn t_with_gender(&self, key: &str, gender: &str) -> String

Gets a gendered translation.

Arguments

• key - Translation key to look up
• gender - Gender key (e.g., “male”, “female”, “neutral”)

Returns

The translated string for the specified gender.

Example

// JSON: "title": { "male": "Mr.", "female": "Ms." }
let text = i18n.translation("ui").t_with_gender("title", "female");
// Result: "Ms."

pub fn t_with_gender_and_arg( &self, key: &str, gender: &str, args: &[&dyn ToString], ) -> String

Gets a gendered translation with placeholder replacement.

Combines gender selection and argument replacement.

Arguments

• key - Translation key to look up
• gender - Gender key
• args - Values to replace placeholders with

Returns

The translated string for the gender with placeholders replaced.

Example

// JSON: "greeting": { "male": "Hello Mr. {{name}}", "female": "Hello Ms. {{name}}" }
let text = i18n.translation("ui").t_with_gender_and_arg("greeting", "male", &[&"Smith"]);
// Result: "Hello Mr. Smith"