NLSEnumLocales

NLS Function: Returns an array containing the language and country combinations supported by the system, in which each array element describes one valid combination.

Module: USE DFNLS

Syntax

ptr => NLSEnumLocales( )

Results:

The result is a pointer to an array of locales, in which each array element describes one supported language and country combination. Each element has the following structure:

 TYPE NLS$EnumLocale
   CHARACTER*(NLS$MaxLanguageLen)  Language
   CHARACTER*(NLS$MaxCountryLen)   Country
   INTEGER(4)                      DefaultWindowsCodepage
   INTEGER(4)                      DefaultConsoleCodepage
 END TYPE

If the application is a Windows or QuickWin application, NLS$DefaultWindowsCodepage is the codepage used by default for the given language and country combination. If the application is a console application, NLS$DefaultConsoleCodepage is the codepage used by default for the given language and country combination.

---

Note: After use, the pointer returned by NLSEnumLocales should be deallocated with the DEALLOCATE statement.

---

Compatibility

CONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIB

See Also: NLSEnumCodepages