Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

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 mapea una colección de strings a sus traducciones individuales, y también proporciona métodos de conveniencia para la pluralización.

Una Translation consta de mensajes. Un mensaje se identifica por su contexto y string sin traducir. A diferencia de gettext, usar una string de contexto vacía en Godot significa no usar ningún contexto.

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()

La string de reglas plurales a aplicar. Véase GNU gettext para ejemplos y más información.

Si está vacía o es inválida, se usan las reglas plurales predeterminadas de TranslationServer.get_plural_rules(). Las reglas plurales en inglés se usan como respaldo.

---

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 = &"") 🔗

Añade un mensaje que involucra traducción plural 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 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 🔗

Devuelve todas las strings traducidas.