_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.
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.