mbbtombc-mbbtombc-l.md

description	title	ms.date	api_name	api_location	api_type	topic_type	f1_keywords	helpviewer_keywords	ms.assetid
Learn more about: _mbbtombc, _mbbtombc_l	_mbbtombc, _mbbtombc_l	4/2/2020	_mbbtombc_l _mbbtombc _o__mbbtombc _o__mbbtombc_l	msvcrt.dll msvcr80.dll msvcr90.dll msvcr100.dll msvcr100_clr0400.dll msvcr110.dll msvcr110_clr0400.dll msvcr120.dll msvcr120_clr0400.dll ucrtbase.dll api-ms-win-crt-multibyte-l1-1-0.dll	DLLExport	apiref	_mbbtombc_l _mbbtombc mbbtombc_l mbbtombc	mbbtombc_l function mbbtombc function _mbbtombc_l function _mbbtombc function	78593389-b0fc-43b6-8c1f-2a6bf702d64e

_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 in Universal Windows Platform apps.

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. For more information, see setlocale, _wsetlocale. 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.

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

Requirements

Routine	Required header
_mbbtombc	<mbstring.h>
_mbbtombc_l	<mbstring.h>

For more compatibility information, see Compatibility.

See also

Data conversion
_mbctombb, _mbctombb_l