Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

National Language Support Library Routines Summary

The following table lists library routines for National Language Support (NLS).

Programs that use these routines must access the NLS library with USE IFNLS. These routines are restricted to Windows* systems.

Routine names are shown in mixed case to make the names easier to understand. When writing your applications, you can use any case.

Name

Routine Type

Description

MBCharLen

Function

Returns the length of the first multibyte character in a string.

MBConvertMBToUnicode

Function

Converts a character string from a multibyte codepage to a Unicode string.

MBConvertUnicodeToMB

Function

Converts a Unicode string to a multibyte character string of the current codepage.

MBCurMax

Function

Returns the longest possible multibyte character for the current codepage.

MBINCHARQQ

Function

Same as INCHARQQ, but can read a single multibyte character at once.

MBINDEX

Function

Same as INDEX, except that multibyte characters can be included in its arguments.

MBJISToJMS

Function

Converts a Japan Industry Standard (JIS) character to a Kanji (Shift JIS or JMS) character.

MBJMSToJIS

Function

Converts a Kanji (Shift JIS or JMS) character to a Japan Industry Standard (JIS) character.

MBLead

Function

Determines whether a given character is the first byte of a multibyte character.

MBLen

Function

Returns the number of multibyte characters in a string, including trailing spaces.

MBLen_Trim

Function

Returns the number of multibyte characters in a string, not including trailing spaces.

MBLGE, MBLGT, MBLLE, MBLLT,MBLEQ, MBLNE

Function

Same as LGE, LGT, LLE, and LLT, and the logical operators .EQ. and .NE., except that multibyte characters can be included in their arguments.

MBNext

Function

Returns the string position of the first byte of the multibyte character immediately after the given string position.

MBPrev

Function

Returns the string position of the first byte of the multibyte character immediately before the given string position.

MBSCAN

Function

Same as SCAN, except that multibyte characters can be included. in its arguments

MBStrLead

Function

Performs a context sensitive test to determine whether a given byte in a character string is a lead byte.

MBVERIFY

Function

Same as VERIFY, except that multibyte characters can be included in its arguments.

NLSEnumCodepages

Function

Returns an array of valid codepages for the current console.

NLSEnumLocales

Function

Returns an array of locales (language/country combinations) installed on the system.

NLSFormatCurrency

Function

Formats a currency number according to conventions of the current locale (language/country).

NLSFormatDate

Function

Formats a date according to conventions of the current locale (language/country).

NLSFormatNumber

Function

Formats a number according to conventions of the current locale (language/country).

NLSFormatTime

Function

Formats a time according to conventions of the current locale (language/country).

NLSGetEnvironmentCodepage

Function

Returns the current codepage for the system Window or console.

NLSGetLocale

Subroutine

Returns the current language, country, and/or codepage.

NLSGetLocaleInfo

Function

Returns information about the current locale.

NLSSetEnvironmentCodepage

Function

Sets the codepage for the console.

NLSSetLocale

Function

Sets the current language, country, and codepage.