National Language Support (NLS) Library Routines

This section contains descriptions of the National Language Support (NLS) library routines, which are restricted to Windows* systems. They are listed in alphabetical order.

To access these library routines, you must specify a USE IFNLS statement in your program.

• MBCharLen (W*S)
  NLS Function: Returns the length, in bytes, of the first character in a multibyte-character string.
• MBConvertMBToUnicode (W*S)
  NLS Function: Converts a multibyte-character string from the current codepage to a Unicode string.
• MBConvertUnicodeToMB (W*S)
  NLS Function: Converts a Unicode string to a multibyte-character string from the current codepage.
• MBCurMax (W*S)
  NLS Function: Returns the longest possible multibyte character length, in bytes, for the current codepage.
• MBINCHARQQ (W*S)
  NLS Function: Performs the same function as INCHARQQ except that it can read a single multibyte character at once, and it returns the number of bytes read as well as the character.
• MBINDEX (W*S)
  NLS Function: Performs the same function as INDEX except that the strings manipulated can contain multibyte characters.
• MBJISToJMS, MBJMSToJIS (W*S)
  NLS Functions: Converts Japan Industry Standard (JIS) characters to Microsoft Kanji (JMS) characters, or converts JMS characters to JIS characters.
• MBLead (W*S)
  NLS Function: Determines whether a given character is the lead (first) byte of a multibyte character sequence.
• MBLen (W*S)
  NLS Function: Returns the number of characters in a multibyte-character string, including trailing blanks.
• MBLen_Trim (W*S)
  NLS Function: Returns the number of characters in a multibyte-character string, not including trailing blanks.
• MBLGE, MBLGT, MBLLE, MBLLT, MBLEQ, MBLNE (W*S)
  NLS Functions: Perform the same functions as LGE, LGT, LLE, LLT and the logical operators .EQ. and .NE. except that the strings being compared can include multibyte characters, and optional flags can modify the comparison.
• MBNext (W*S)
  NLS Function: Returns the position of the first lead byte or single-byte character immediately following the given position in a multibyte-character string.
• MBPrev (W*S)
  NLS Function: Returns the position of the first lead byte or single-byte character immediately preceding the given string position in a multibyte-character string.
• MBSCAN (W*S)
  NLS Function: Performs the same function as SCAN except that the strings manipulated can contain multibyte characters.
• MBStrLead (W*S)
  NLS Function: Performs a context-sensitive test to determine whether a given character byte in a string is a multibyte-character lead byte.
• MBVERIFY (W*S)
  NLS Function: Performs the same function as VERIFY except that the strings manipulated can contain multibyte characters.
• NLSEnumCodepages (W*S)
  NLS Function: Returns an array containing the codepages supported by the system, with each array element describing one valid codepage.
• NLSEnumLocales (W*S)
  NLS Function: Returns an array containing the language and country combinations supported by the system, in which each array element describes one valid combination.
• NLSFormatCurrency (W*S)
  NLS Function: Returns a correctly formatted currency string for the current locale.
• NLSFormatDate (W*S)
  NLS Function: Returns a correctly formatted string containing the date for the current locale.
• NLSFormatNumber (W*S)
  NLS Function: Returns a correctly formatted number string for the current locale.
• NLSFormatTime (W*S)
  NLS Function: Returns a correctly formatted string containing the time for the current locale.
• NLSGetEnvironmentCodepage (W*S)
  NLS Function: Returns the codepage number for the system (Window) codepage or the console codepage.
• NLSGetLocale (W*S)
  NLS Subroutine: Returns the current language, country, or codepage.
• NLSGetLocaleInfo (W*S)
  NLS Function: Returns information about the current locale.
• NLSSetEnvironmentCodepage (W*S)
  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.
• NLSSetLocale (W*S)
  NLS Function: Sets the current language, country, or codepage.