===== Coming in a future release =====

In prior Clarion versions, internationalization settings were set or modified by using the ENV file or by calls to the LOCALE function. Clarion 11 introduces new settings for internationalization: the **codepage number** and **locale id number **(recommended in place of the ENV file). These settings allow conformant processing of both ANSI and Unicode strings while the old implementation is useful for ANSI strings only.

**As of version 11 the recommended method to implement support for Unicode and apply international settings is to use the new **

**[[codepage.htm|PROP:Codepage]] and [[prop locale.htm|PROP:Locale]] properties.**

The values for the code page and locale id can be set several different ways:

·by setting **PROP:Codepage** and **PROP:Locale** properties respectively for the **SYSTEM** property (this is the preferred method), for example:\\  \\ **SYSTEM {PROP:Codepage}** = 1253         !Greek

**SYSTEM {PROP:Locale}** = 1032                !Greek

·by calling the **LOCALE** function with the first parameter equal to '**CLACODEPAGE**' and '**CLALCID**' respectively, for example:\\

**LOCALE('CLACODEPAGE'**, 1253)

**LOCALE('CLALCID'**, 1032)\\

·by specifying the **CLACODEPAGE** and **CLALCID** parameters in the program [[env file.htm|ENV file]].

****Note:** The RTL does not check the values of the codepage number or the locale id for compatibility.

It is recommended to set the locale id to provide the Clarion RTL with the names and abbreviations of months, days of week, AM/PM identifiers, and other internationalization settings. If the program does not set the code page and locale id the RTL uses the settings for the current Windows user. \\

Using any of the above methods to set the code page and locale id, the settings are applied //before// reading the ENV file (if it exists). This means  that the settings in the ENV file **//override//** corresponding settings that are set from PROP:CODEPAGE and PROP:LOCALE (locale id). Settings for CLACASE, CLACOLSEQ and CLADIGRAPH parameters in the ENV file or specified by calling the LOCALE function do not affect processing of Unicode strings.

Changing the code page setting at run time (by setting the PROP:CODEPAGE property or by calling the LOCALE function) resets all previous settings for CLACHARSET, CLASYSCHARSET, CLACASE, CLACOLSEQ and CLADIGRAPH parameters. Changing the locale id setting at run time resets all previous settings for CLACASE, CLACOLSEQ, CLADIGRAPH, CLAMONTH, CLAMON, CLADOWNAME, CLADOW, CLAAMPM and CLABUTTON parameters.

.

The RTL provides two functions to support working with ANSI and Unicode strings; TOUNICIDE() and TOANSI(). The [[tounicode.htm|TOUNICODE]] and [[toansi.htm|TOANSI]] functions have 2 parameters: the first is a string expression to convert to Unicode or to ANSI, the second one is a code page number applied for the ANSI string parameter (TOUNICODE) or the result (TOANSI). This second parameters allows for conversions to and from ANSI strings encoded for languages other than the current system language. \\  \\ The TOANSI function allows you to convert ANSI and Unicode strings to a character sequence encoded in UTF-8 by passing the value 65001 as the second parameter.\\

**See Also:**

[[codepage.htm|PROP:CODEPAGE]]

[[prop locale.htm|PROP:LOCALE]]

[[locale  load environment file .htm|LOCALE]]

[[tounicode.htm|TOUNICODE]]

[[toansi.htm|TOANSI]]

[[property expressions.htm|SYSTEM]]

[[example env settings.htm|Example of ENV settings]]

[[prop charset.htm|PROP:CharSet]]