_mbbtombc, _mbbtombc_l

Converts a single-byte multibyte character to a corresponding double-byte multibyte character.

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 for more information. The _mbbtombc version of this function uses the current locale for this locale-dependent behavior; the _mbbtombc_l version is identical except that it use the locale parameter passed in instead. For more information, see Locale.

In earlier versions, _mbbtombc was called hantozen. For new code, use _mbbtombc instead.

Requirements

Routine

Required header

_mbbtombc

<mbstring.h>

_mbbtombc_l

<mbstring.h>

For more compatibility information, see Compatibility in the Introduction.

.NET Framework Equivalent

Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.

See Also

Concepts

Data Conversion

_mbctombb, _mbctombb_l