_mbctombb, _mbctombb_l

Article
06/05/2017

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 _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 with /ZW.

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

.NET Framework Equivalent

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