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

Eredita: Resource < RefCounted < Object

Ereditato da: OptimizedTranslation

Una traduzione linguistica che mappa una raccolta di stringhe alle loro singole traduzioni.

Descrizione

Translation mappa una raccolta di stringhe alle loro traduzioni individuali e fornisce anche metodi di comodità per gestire i plurali.

Una Translation è composta da messaggi. Un messaggio è identificato dal suo contesto e dalla stringa non tradotta. A differenza di gettext, usare una stringa di contesto vuota in Godot significa non usare alcun contesto.

Tutorial

• Internazionalizzazione dei giochi

• Ottimizzazione attraverso gettext

• Localizzazione

Proprietà

String	locale	"en"
String	plural_rules_override	""

Metodi

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

---

Descrizioni delle proprietà

String locale = "en" 🔗

• void set_locale(value: String)

• String get_locale()

La lingua della traduzione.

---

String plural_rules_override = "" 🔗

• void set_plural_rules_override(value: String)

• String get_plural_rules_override()

La stringa delle regole per il plurale da applicare. Consulta GNU gettext per esempi e ulteriori informazioni.

Se vuota o non valida, si utilizzano le regole predefinite da TranslationServer.get_plural_rules(). Si utilizzano le regole in inglese come alternative di riserva.

---

Descrizioni dei metodi

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

Metodo virtuale per sovrascrivere get_message().

---

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

Metodo virtuale per sovrascrivere get_plural_message().

---

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

Aggiunge un messaggio se non esiste, seguito dalla sua traduzione.

Un contesto aggiuntivo potrebbe essere usato per specificare il contesto della traduzione o differenziare le parole polisemiche.

---

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

Aggiunge un messaggio se non esiste, che include una traduzione al plurale, seguito dalla sua traduzione.

Un contesto aggiuntivo potrebbe essere usato per specificare il contesto della traduzione o differenziare le parole polisemiche.

---

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

Elimina un messaggio.

---

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

Restituisce la traduzione di un messaggio.

---

int get_message_count() const 🔗

Restituisce il numero di messaggi esistenti.

---

PackedStringArray get_message_list() const 🔗

Restituisce le chiavi di tutti i messaggi, ovvero il contesto e le stringhe non tradotte di ciascun messaggio.

Nota: Se un messaggio non utilizza un contesto, l'elemento corrispondente è la stringa non tradotta. Altrimenti, l'elemento corrispondente è il contesto e la stringa non tradotta separati dal carattere EOT (U+0004). Questo è fatto per motivi di compatibilità.

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

---

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

Restituisce la traduzione di un messaggio che include i plurali.

Il numero n è il numero o la quantità dell'oggetto plurale. Sarà utilizzato per guidare il sistema di traduzione a recuperare la forma plurale corretta per la lingua selezionata.

Nota: I plurali sono supportati solo nelle traduzioni basate su gettext (PO), non in CSV.

---

PackedStringArray get_translated_message_list() const 🔗

Restituisce tutte le stringe tradotte.