_mbctombb, _mbctombb_l

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

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_lreturns the single-byte character that corresponds to c; otherwise it returns c.

Remarks

The _mbctombb and _mbctombb_lfunctions 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.

Requirements

Routine

Required header

_mbctombb

<mbstring.h>

_mbctombb_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

_mbbtombc, _mbbtombc_l

_mbcjistojms, _mbcjistojms_l, _mbcjmstojis, _mbcjmstojis_l

_mbctohira, _mbctohira_l, _mbctokata, _mbctokata_l

_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l