Interpretation of Multibyte-Character Sequences

Most multibyte-character routines in the Microsoft run-time library recognize multibyte-character sequences relating to a multibyte code page. The output value is affected by the setting of the LC_CTYPE category setting of the locale; see setlocale for more information. The versions of these functions without the _l suffix use the current locale for this locale-dependent behavior; the versions with the _l suffix are identical except that they use the locale parameter passed in instead.

Locale-Dependent Multibyte Routines

Routine

Use

_mbclen, mblen, _mblen_l

Validate and return number of bytes in multibyte character

strlen, strlen_l, wcslen, wcslen_l, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_l

For multibyte character strings: validate each character in string; return string length. For wide character strings: return string length.

mbstowcs, _mbstowcs_l, mbstowcs_s, _mbstowcs_s_l

Convert sequence of multibyte characters to corresponding sequence of wide characters

mbtowc, _mbtowc_l

Convert multibyte character to corresponding wide character

wcstombs, _wcstombs_l, wcstombs_s, _wcstombs_s_l

Convert sequence of wide characters to corresponding sequence of multibyte characters

wctomb, _wctomb_l, wctomb_s, _wctomb_s_l

Convert wide character to corresponding multibyte character

See Also

Concepts

Internationalization

Run-Time Routines by Category