_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

将字符串转换为小写。 提供这些函数的更安全版本；请参阅 _strlwr_s、_strlwr_s_l、_mbslwr_s、_mbslwr_s_l、_wcslwr_s、_wcslwr_s_l。

重要

_mbslwr 和 _mbslwr_l 无法用于在 Windows 运行时中执行的应用程序。 有关详细信息，请参阅通用 Windows 平台应用中不支持的 CRT 函数。

语法

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 后缀的版本相同，只不过它们使用传递的区域设置。 有关详细信息，请参阅 Locale。

_wcslwr 和 _mbslwr 函数是 _strlwr 的宽字符及多字节字符版本。 _wcslwr 的自变量和返回值为宽字符字符串。 _mbslwr 的自变量和返回值为多字节字符字符串。 否则这三个函数否则具有相同行为。

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

在 C++ 中，这些函数具有模板重载，以调用这些函数的更新、更安全副本。 有关详细信息，请参阅安全模板重载。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

一般文本例程映射

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 );
}

Mixed: The String to End All Strings!
Lower: the string to end all strings!
Upper: THE STRING TO END ALL STRINGS!

另请参阅

字符串操作
区域设置
_strupr、_strupr_l、_mbsupr、_mbsupr_l、_wcsupr_l、_wcsupr