Internationalization and localization tools


Locale-Sensitive Windows C++ Function

BOOL IsDBCSLeadByteEx(UINT CodePage, BYTE TestChar);

Internationalization (I18n) Function Overview

The IsDBCSLeadByteEx function returns a non-zero value if TestChar is the first byte of a two-byte character in a double-byte character set (DBCS). Otherwise, it returns 0 and sets extended error information that can be obtained by calling GetLastError.

The function uses the code page specified by CodePage to test the semantics of the character. This value can be a specific code page value, or one of the following predefined values:
CP_ACP to use system default ANSI code page;
CP_MACCP (only on Windows NT/2000/XP) to use the system default Macintosh code page;
CP_OEMCP to use system default OEM code page;
CP_THREAD_ACP (only on Windows 2000/XP) to use the current thread's ANSI code page.

I18n Issues

In an internationalized application, the ANSI code page may vary. Consequently, CodePage should not be a hardcoded value and should be independent of the user's system settings. Either set CodePage to CP_THREAD_ACP to use the ANSI code page of the application's current thread, if supported, or, retrieve the specific code page value from a resource file and pass that in as the CodePage argument.

Recommended Replacements*

There are no variations of the function call: a single byte is expected.

*If you're already using the recommended function, see I18n Issues for other reasons why Globalyzer is detecting the function.

Locale-Sensitive Windows C++ Functions

 

Lingoport internationalization and localization services and software