Translation

Hereda: Resource < RefCounted < Object

Heredado por: OptimizedTranslation

Una traducción de idioma que asigna una colección de strings a sus traducciones individuales.

Descripción

Translation maps a collection of strings to their individual translations, and also provides convenience methods for pluralization.

A Translation consists of messages. A message is identified by its context and untranslated string. Unlike gettext, using an empty context string in Godot means not using any context.

Tutoriales

• Internacionalizando los juegos

• Localización usando gettext

• Localización

Propiedades

String	locale	"en"
String	plural_rules_override	""

Métodos

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

---

Descripciones de Propiedades

String locale = "en" 🔗

• void set_locale(value: String)

• String get_locale()

El locale de la traducción.

---

String plural_rules_override = "" 🔗

• void set_plural_rules_override(value: String)

• String get_plural_rules_override()

The plural rules string to enforce. See GNU gettext for examples and more info.

If empty or invalid, default plural rules from TranslationServer.get_plural_rules() are used. The English plural rules are used as a fallback.

---

Descripciones de Métodos

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

Método virtual para sobrescribir get_message().

---

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

Método virtual para sobrescribir get_plural_message().

---

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

Añade un mensaje si no existe, seguido de su traducción.

Se podría usar un contexto adicional para especificar el contexto de la traducción o diferenciar palabras polisémicas.

---

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

Adds a message involving plural translation if nonexistent, followed by its translation.

An additional context could be used to specify the translation context or differentiate polysemic words.

---

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

Borra un mensaje.

---

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

Devuelve la traducción de un mensaje.

---

int get_message_count() const 🔗

Devuelve el número de mensajes existentes.

---

PackedStringArray get_message_list() const 🔗

Returns the keys of all messages, that is, the context and untranslated strings of each message.

Note: If a message does not use a context, the corresponding element is the untranslated string. Otherwise, the corresponding element is the context and untranslated string separated by the EOT character (U+0004). This is done for compatibility purposes.

for key in translation.get_message_list():
    var p = key.find("\u0004")
    if p == -1:
        var untranslated = key
        print("Message %s" % untranslated)
    else:
        var context = key.substr(0, p)
        var untranslated = key.substr(p + 1)
        print("Message %s with context %s" % [untranslated, context])

---

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

Devuelve la traducción de un mensaje que involucra plurales.

El número n es el número o cantidad del objeto plural. Se utilizará para guiar al sistema de traducción para obtener la forma plural correcta para el idioma seleccionado.

Nota: Los plurales solo se admiten en traducciones basadas en gettext (PO), no en CSV.

---

PackedStringArray get_translated_message_list() const 🔗

Returns all the translated strings.