Skip to content

language-module.md

Latest commit

 

History

History
128 lines (91 loc) · 3.07 KB

language-module.md

File metadata and controls

128 lines (91 loc) · 3.07 KB

Bones Milestone specific LUA modules

Language

Bones delivers the Milestone devices in multiple languages. Therefore your programs should optimally support multilingualism. To keep the effort as low as possible, there is the module'' Language''. The functions of this module allow you to manage tables with character strings in different languages. Access is via ISO 639-1 language abbreviation or via the index within the table. The following table represents the order of the languages within a translation table:

local ltable = {
  {"English", "EN"},
  {"German", "DE"},
  {"French", "FR"},
  {"Italian", "IT"},
  {"Spanish", "ES"},
  {"Swedish", "SV"},
  {"Dutch", "NL"},
  {"Norwegian", "NO"},
  {"Danish", "DA"},
  {"Polish", "PL"},
  {"Icelandic", "IS"},
  {"Japanese", "JA"},
  {"Portugese", "PT"},
  {"Turkish", "TR"},
  {"Arabic", "AR"},
  {"Catalan", "CA"},
  {"Czech", "CZ"},
  {"Finnish", "FI"},
  {"N/A", "NA"},
  {"Greek", "EL"},
  {"Russia", "RU"},
  {"Portugese Brazil", "PT-BR"},
  {"Chinese", "CH"},
}

Functions:

machid

machid()

machid returns the language identification number of the corresponding system. This identification number corresponds to the index of the respective language in the following Table.

id

id(ISOlang)

id returns the language identification number for an ISO 639-1 language abbreviation. See also the following Table.

set

set(ISOlang, text, texttable)

set sets the specified text as language in the translation table texttable, which was specified by the ISOlang abbreviation. Return value is the new table.

Example::

local second
second = language.set("EN","seconds")
second = language.set("DE","Sekunden", introhigh)

Alternatively, the texts can also be transferred when the table is created:

local second = {"seconds", "Sekunden"}

Please note the following Table regarding the order.

set roughly corresponds to the following call:

texttable[id(ISOlang)] = text

get

get(ISOlang, texttable)

get returns the text of the translation table texttable specified by the ISOlang abbreviation.

Example::

local second = {"seconds", "Sekunden"}
print('50' .. language.get("DE", second))

get roughly corresponds to the following call:

texttable[id(ISOlang)]

getlocal

getlocal(texttable)

getlocal returns the text from texttable in the language of the current system.

local second = {"seconds", "Sekunden"}
print('50 .. language.getlocal(second))

to make the usage even shorter you can set a corresponding abbreviation (e.g. _T):

local _T = language.getlocal -- to get local text  
local second = {"seconds", "Sekunden"}
print('50 .. _T(second))