Interpretation of Multibyte-Character Sequences
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer

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

© 2016 Microsoft