Biblioteca Locale

Biblioteca que contém funções para lidar com idiomas e regiões, incluindo funcionalidade para permitir um plug-in em várias línguas

Exemplo de uso:

-- Primeiro, é necessário usar a unidade "locale.lua"
require("locale.lua");

-- Agora é possível acessar as funções da biblioteca
Locale.FUNCAO_DA_BIBLIOTECA(Parametro1, Parametro2, ...);

Funções da biblioteca Locale

function lang(txtId)
ou
function LANG(txtId)
ou
function Locale.lang(txtId)

Percorre todos os arquivos ".lang" do plug-in à procura de um texto cuja identificação seja igual à passada como parâmetro e que combine com o idioma atual do usuário.

Esta função é a principal para você obter strings correto para o idioma do usuário.

Parâmetros:

txtId - Uma cadeia de caracteres que identifica o texto que deseja obter

Retorno:

Uma cadeia de caracteres contendo o texto para o idioma do usuário.

Observações:

A busca ocorre em todos os arquivos de extensão .lang de forma eficiente.
Caso a busca não encontre o texto para o idioma do usuário, a busca retornará uma cadeia de caracteres de outro idioma. A função emite um erro se "txtId" não for conhecido em nenhum idioma.
Leia o tutorial de como criar um plug-in multi-línguas para exemplo!

function Locale.loadLangTexts(langTexts)

Carrega, em tempo de execução, um arquivo ".lang" para que mais textos traduzidos possam ser encontrados pelas funções Locale.lang e Locale.tryLang.

Parâmetros:

langTexts - Uma cadeia de caracteres com o conteúdo do arquivo .lang que será carregado em tempo de execução.

Observações:

Leia o tutorial de como criar um plug-in multi-línguas para exemplo!

function Locale.newLocalizedTexts()

Creates an isolated context to work with translations without affecting the plugin translations.

Arguments:

None

Return:

A new LocalizedTexts object

function tryLang(txtId)
ou
function tryLANG(txtId)
ou
function Locale.tryLang(txtId)

Idêntico à função lang, porém retorna nil ao invés de um erro quando não encontra a tradução.

Created with the Personal Edition of HelpNDoc: Easily share your documentation with the world through a beautiful website