NLSSetEnvironmentCodepage (W*32, W*64)

NLS Function: Sets the codepage for the current console. The specified codepage affects the current console program and any other programs launched from the same console. It does not affect other open consoles or any consoles opened later.

Module: USE IFNLS

Syntax

result = NLSSetEnvironmentCodepage (codepage, flags)

codepage
(Input) INTEGER(4). Number of the codepage to set as the console codepage.

flags
(Input) INTEGER(4). Must be set to NLS$ConsoleEnvironmentCodepage.

Results

The result type is INTEGER(4). The result is zero if successful. Otherwise, returns one of the following error codes (defined in IFNLS.F90):

• NLS$ErrorInvalidCodepage - codepage is invalid or not installed on the system
• NLS$ErrorInvalidFlags - flags is not valid
• NLS$ErrorNoConsole - There is no console associated with the given application; so operations, with the console codepage are not possible

The flags argument must be NLS$ConsoleEnvironmentCodepage; it cannot be NLS$WindowsEnvironmentCodepage. NLSSetEnvironmentCodepage does not affect the Windows* codepage.

Compatibility

CONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIB

See Also

NLSGetEnvironmentCodepage, Building Applications: Locale Setting and Inquiry Routines