_mbbtombc, _mbbtombc_l
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at _mbbtombc, _mbbtombc_l.
Converts a single-byte multibyte character to a corresponding double-byte multibyte character.
Important
This API cannot be used in applications that execute in the Windows Runtime. For more information, see CRT functions not supported with /ZW.
Syntax
unsigned int _mbbtombc(
unsigned int c
);
unsigned int _mbbtombc_l(
unsigned int c,
_locale_t locale
);
Parameters
c
Single-byte character to convert.
locale
Locale to use.
Return Value
If _mbbtombc successfully converts c, it returns a multibyte character; otherwise, it returns c.
Remarks
The _mbbtombc function converts a given single-byte multibyte character to a corresponding double-byte multibyte character. Characters must be within the range 0x20 – 0x7E or 0xA1 – 0xDF to be converted.
The output value is affected by the setting of the LC_CTYPE category setting of the locale; see setlocale, _wsetlocale for more information. The versions of this function are identical, except that _mbbtombc uses the current locale for this locale-dependent behavior and _mbbtombc_l instead uses the locale parameter that's passed in. For more information, see Locale.
In earlier versions, _mbbtombc was named hantozen. For new code, use _mbbtombc.
Requirements
| Routine | Required header |
|---|---|
_mbbtombc |
<mbstring.h> |
_mbbtombc_l |
<mbstring.h> |
For more compatibility information, see Compatibility.
.NET Framework Equivalent
Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.