_strlwr， _wcslwr， _mbslwr， _strlwr_l， _wcslwr_l， _mbslwr_l

项目
04/10/2013

将字符串转换为小写。这些功能的更安全版本可用；请参见 _strlwr_s， _strlwr_s_l， _mbslwr_s， _mbslwr_s_l， _wcslwr_s， _wcslwr_s_l。

重要

_mbslwr 和 _mbslwr_l 不能在运行时的窗口执行的应用程序。有关更多信息，请参见 CRT 函数不支持与 /ZW。

char *_strlwr(
   char * str
);
wchar_t *_wcslwr(
   wchar_t * str
);
unsigned char *_mbslwr(
   unsigned char * str
);
char *_strlwr_l(
   char * str,
   _locale_t locale
);
wchar_t *_wcslwr_l(
   wchar_t * str,
   _locale_t locale
);
unsigned char *_mbslwr_l(
   unsigned char * str,
   _locale_t locale 
);
template <size_t size>
char *_strlwr(
   char (&str)[size]
); // C++ only
template <size_t size>
wchar_t *_wcslwr(
   wchar_t (&str)[size]
); // C++ only
template <size_t size>
unsigned char *_mbslwr(
   unsigned char (&str)[size]
); // C++ only
template <size_t size>
char *_strlwr_l(
   char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
wchar_t *_wcslwr_l(
   wchar_t (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
unsigned char *_mbslwr_l(
   unsigned char (&str)[size],
   _locale_t locale 
); // C++ only

参数

str
转换的 null 终止的字符串转换为小写。
locale
使用的区域设置。

返回值

这些函数都返回一个指向该转换的字符串。由于修改就地完成，返回的指针是作为指针将作为输入参数的相同。没有任何返回值保留指示错误。

备注

_strlwr功能将 str 的所有大写字母转换为小写。取决于 LC_CTYPE 类别设置区域设置。其他字符不受影响。有关 LC_CTYPE的更多信息，请参见 setlocale。这些功能的版本不_l 后缀的为其与区域设置相关的行为使用当前区域设置；与 _l后缀的版本相同，只不过它们使用的区域设置。有关更多信息，请参见区域设置。

_wcslwr 和 _mbslwr 功能是 _strlwr的宽字符和多字节字符版本。参数和返回 _wcslwr 的值是宽字符字符串；这些 _mbslwr 的多字节字符字符串。这三个功能否则具有相同的行为。

如果 str 是 NULL 指针，无效参数调用处理程序，如参数验证所述。如果执行允许继续，这些函数返回原始字符串并将 errno 到 EINVAL。

在 C++ 中，这些函数的调用的模板超负载越 + 新，保证这些函数副本。有关更多信息，请参见安全模板重载。

一般文本例程映射

TCHAR.H 实例	未定义的_UNICODE & _MBCS	定义的_MBCS	定义的_UNICODE
_tcslwr	_strlwr	_mbslwr	_wcslwr
_tcslwr_l	_strlwr_l	_mbslwr_l	_wcslwr_l

要求

实例	必需的标头
_strlwr, _strlwr_l	<string.h>
_wcslwr, _wcslwr_l	<string.h> 或 <wchar.h>
_mbslwr, _mbslwr_l	<mbstring.h>

有关其他的兼容性信息，请参见中介绍的兼容性。

示例

// crt_strlwr.c
// compile with: /W3
// This program uses _strlwr and _strupr to create
// uppercase and lowercase copies of a mixed-case string.
#include <string.h>
#include <stdio.h>

int main( void )
{
   char string[100] = "The String to End All Strings!";
   char * copy1 = _strdup( string ); // make two copies
   char * copy2 = _strdup( string );

   _strlwr( copy1 ); // C4996
   // Note: _strlwr is deprecated; consider using _strlwr_s instead
   _strupr( copy2 ); // C4996
   // Note: _strupr is deprecated; consider using _strupr_s instead

   printf( "Mixed: %s\n", string );
   printf( "Lower: %s\n", copy1 );
   printf( "Upper: %s\n", copy2 );

   free( copy1 );
   free( copy2 );
}