Locale-Sensitive C/C++ String Operation Function

char *_strlwr_l(char* str, _locale_t locale);

unsigned char *_mbslwr_l(unsigned char* str, _locale_t locale);

wchar_t *_wcslwr_l(wchar_t* str, _locale_t locale);

_TXCHAR *_tcslwr_l(const _TXCHAR* str, _locale_t locale);

Internationalization (I18n) Function Overview

The _strlwr_l function converts any uppercase characters in str to lowercase letters, using the LC_CTYPE category setting of the passed in locale, and returns a pointer to the converted string.

_mbslwr_l and _wcslwr_l are the multibyte and wide versions of _strlwr. The argument and return value of _mbslwr_l are multibyte-character strings; those of _wcslwr_l are wide-character strings.

_tcslwr_l is the Windows-only Generic version of the function; with the _MBCS or _UNICODE compiler flags determining its mapping to either _mbslwr_l or _wcslwr_l.

I18n Issues

Use the appropriate version of the function as required for internationalization support, noting the following:

Ensure that the correct locale is passed in.

Consider using the more secure versions of these functions, _strlwr_s_l, _wcslwr_s_l, _tcslwr_s_l, if available.

Recommended Replacements*

Microsoft Windows MBCS	_mbslwr_l
Microsoft Windows Unicode	_wcslwr_l
Microsoft Windows Generic	_tcslwr_l

Locale-Sensitive C/C++ String Operation Functions