Translation

Наследует: Resource < RefCounted < Object

Наследуется от: OptimizedTranslation

Перевод языка, который сопоставляет набор строк с их индивидуальными переводами.

Описание

Translation — это ресурсы, которые можно загружать и выгружать по требованию. Они сопоставляют набор строк с их индивидуальными переводами, а также предоставляют удобные методы для плюрализации.

Обучающие материалы

• Интернационализация игр

• Локализация с использованием gettext

• Локали

Свойства

String

locale

"en"

Методы

StringName	_get_message(src_message: StringName, context: StringName) virtual const
StringName	_get_plural_message(src_message: StringName, src_plural_message: StringName, n: int, context: StringName) virtual const
void	add_message(src_message: StringName, xlated_message: StringName, context: StringName = &"")
void	add_plural_message(src_message: StringName, xlated_messages: PackedStringArray, context: StringName = &"")
void	erase_message(src_message: StringName, context: StringName = &"")
StringName	get_message(src_message: StringName, context: StringName = &"") const
int	get_message_count() const
PackedStringArray	get_message_list() const
StringName	get_plural_message(src_message: StringName, src_plural_message: StringName, n: int, context: StringName = &"") const
PackedStringArray	get_translated_message_list() const

---

Описания свойств

String locale = "en" 🔗

• void set_locale(value: String)

• String get_locale()

Локаль перевода.

---

Описания метода

StringName _get_message(src_message: StringName, context: StringName) virtual const 🔗

Виртуальный метод для переопределения get_message().

---

StringName _get_plural_message(src_message: StringName, src_plural_message: StringName, n: int, context: StringName) virtual const 🔗

Виртуальный метод для переопределения get_plural_message().

---

void add_message(src_message: StringName, xlated_message: StringName, context: StringName = &"") 🔗

Добавляет сообщение, если оно отсутствует, а затем его перевод.

Дополнительный контекст может использоваться для указания контекста перевода или дифференциации многозначных слов.

---

void add_plural_message(src_message: StringName, xlated_messages: PackedStringArray, context: StringName = &"") 🔗

Добавляет сообщение с переводом множественного числа, если такового не существует, а затем его перевод.

Для указания контекста перевода или различения многозначных слов можно использовать дополнительный контекст.

Примечание: Множественное число поддерживается только в переводах на основе GetText (PO), но не в CSV-файлах.

---

void erase_message(src_message: StringName, context: StringName = &"") 🔗

Стереть сообщение.

---

StringName get_message(src_message: StringName, context: StringName = &"") const 🔗

Возвращает перевод сообщения.

---

int get_message_count() const 🔗

Возвращает количество существующих сообщений.

---

PackedStringArray get_message_list() const 🔗

Возвращает все сообщения (ключи).

---

StringName get_plural_message(src_message: StringName, src_plural_message: StringName, n: int, context: StringName = &"") const 🔗

Возвращает перевод сообщения, содержащего формы множественного числа.

Число n — это количество объектов множественного числа. Оно будет использоваться системой перевода для выбора правильной формы множественного числа для выбранного языка.

Примечание: Множественное число поддерживается только в переводах на основе GetText (PO), но не в CSV-файлах.

---

PackedStringArray get_translated_message_list() const 🔗

Возвращает все сообщения (переведенный текст).