_mbctombb, _mbctombb_l

Converts a double-byte multibyte character to a corresponding single-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 in Universal Windows Platform apps.

Syntax

unsigned int _mbctombb(
   unsigned int c
);
unsigned int _mbctombb_l(
   unsigned int c,
   _locale_t locale
);

Parameters

c
Multibyte character to convert.

locale
Locale to use.

Return Value

If successful, _mbctombb and _mbctombb_l returns the single-byte character that corresponds to c; otherwise it returns c.

Remarks

The _mbctombb and _mbctombb_l functions convert a given multibyte character to a corresponding single-byte multibyte character. Characters must correspond to single-byte characters 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 version of this function without the _l suffix uses the current locale for this locale-dependent behavior; the version with the _l suffix is identical except that it use the locale parameter passed in instead. For more information, see Locale.

In previous versions, _mbctombb was called zentohan. Use _mbctombb instead.

By default, this function's global state is scoped to the application. To change this, see Global state in the CRT.

Requirements

Routine Required header
_mbctombb <mbstring.h>
_mbctombb_l <mbstring.h>

For more compatibility information, see Compatibility.

See also

Data Conversion
_mbbtombc, _mbbtombc_l
_mbcjistojms, _mbcjistojms_l, _mbcjmstojis, _mbcjmstojis_l
_mbctohira, _mbctohira_l, _mbctokata, _mbctokata_l
_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l