_mbbtombc, _mbbtombc_l

 

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

Syntax

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.

See Also

Data Conversion
_mbctombb, _mbctombb_l