MIAMEX 190: Get / Set Language

Added February 2017

xcall MIAMEX, MX_LANGUAGE, opcode, lang {,status}

MIAMEX function MX_LANGUAGE (190) retrieves or sets the current language.

Parameters

opcode  (Num)  [in]

0 to retrieve, 1 to set

lang  (String)  [in/out]

For the get operation, returns the current language name. Note that this is the name defined within the LDF file, not the name OF the LDF file. For example, the englsh.ldf file contains the name "ENGLISH."

For the set operation, must specify the name of the LDF file to load. This can be either an unadorned filename, like "ENGLSH" (in which case it will look for dsk0:lang.ldf[1,6]), or a complete filespec. Note that although the status parameter will indicate if the file was found, the only to really evaluate the success of the operation is to use GTLANG.SBR to retrieve all the attributes of the new language.

status  (Signed Num)  [out]

If specified, returns 0 for success, else -1 if the specified LDF is not found.

History

2017 February, A-Shell 6.4.1543:  Function added to A-Shell.