NLSSetEnvironmentCodepage

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 DFNLS

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 is of type INTEGER(4). The result is zero if successful. Otherwise, returns one of the following error codes (defined in DFNLS.F90 in /DF/INCLUDE):

• 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