Intel® Fortran Compiler Classic and Intel® Fortran Compiler Developer Guide and Reference

ID 767251
Date 3/31/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

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. This routine is only available for Windows.

Module

USE IFNLS

result = NLSSetEnvironmentCodepage (codepage,flags)

codepage

(Input) INTEGER(4). Is the 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, it 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 applicatio. So operations, with the console codepage are not possible

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