_strlwr_s， _strlwr_s_l， _mbslwr_s， _mbslwr_s_l， _wcslwr_s， _wcslwr_s_l

项目
04/10/2013

将字符串转换为小写，使用传入的当前区域设置或区域设置对象。这些是 _strlwr， _wcslwr， _mbslwr， _strlwr_l， _wcslwr_l， _mbslwr_l 的版本与安全增强如 CRT中的安全功能所述。

重要

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

errno_t _strlwr_s(
   char *str,
   size_t numberOfElements
);
errno_t _strlwr_s_l(
   char *str,
   size_t numberOfElements,
   _locale_t locale
);
errno_t _mbslwr_s(
   unsigned char *str,
   size_t numberOfElements
);
errno_t _mbslwr_s_l(
   unsigned char *str,
   size_t numberOfElements,
   _locale_t locale
);
errno_t _wcslwr_s(
   wchar_t *str,
   size_t numberOfElements
);
errno_t _wcslwr_s_l(
   wchar_t *str,
   size_t numberOfElements,
   _locale_t locale
);
template <size_t size>
errno_t _strlwr_s(
   char (&str)[size]
); // C++ only
template <size_t size>
errno_t _strlwr_s_l(
   char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
errno_t _mbslwr_s(
   unsigned char (&str)[size]
); // C++ only
template <size_t size>
errno_t _mbslwr_s_l(
   unsigned char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
errno_t _wcslwr_s(
   wchar_t (&str)[size]
); // C++ only
template <size_t size>
errno_t _wcslwr_s_l(
   wchar_t (&str)[size],
   _locale_t locale
); // C++ only

参数

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

返回值

零，如果成功；在失败的一个非零错误代码。

这些功能验证其参数。如果 str 不是有效的 null 终止的字符串，无效参数调用处理程序，如参数验证所述。如果执行允许继续，函数返回 EINVAL 并将 errno 到 EINVAL。如果 numberOfElements 与该字符串的长度，函数来返回 EINVAL 并将 errno 到 EINVAL。

备注

_strlwr_s 函数，例如，在 str 的所有大写字母转换为小写。 _mbslwr_s 是 _strlwr_s的多字节字符版本。_wcslwr_s 是 _strlwr_s的宽字符版本。

输出值受设置 LC_CTYPE 类设置的影响区域设置；请参见 setlocale 有关更多信息。这些功能的版本不 _l 后缀为该区域设置相关的行为使用当前区域设置；与 _l 后缀的版本相同，只不过它们使用传入的区域设置参数。有关更多信息，请参见区域设置。

在 C++ 中，使用这些功能由模板超加载简化；超加载可能推断缓冲区长度 (自动不再需要指定范围参数)，并且还可以用以较新，安全重复自动替换旧，不安全的功能。有关更多信息，请参见安全模板重载。

这些函数的" debug "版本用 0xFD 首先加载缓冲区。若要禁用此行为，请使用 _CrtSetDebugFillThreshold。

一般文本例程映射

TCHAR.H 实例	未定义的_UNICODE & _MBCS	定义的_MBCS	定义的_UNICODE
_tcslwr_s	_strlwr_s	_mbslwr_s	_wcslwr_s
_tcslwr_s_l	_strlwr_s_l	_mbslwr_s_l	_wcslwr_s_l

要求

实例	必需的标头
_strlwr_s, _strlwr_s_l	<string.h>
_mbslwr_s, _mbslwr_s_l	<mbstring.h>
_wcslwr_s, _wcslwr_s_l	<string.h> 或 <wchar.h>

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

示例

// crt_strlwr_s.cpp
// This program uses _strlwr_s and _strupr_s to create
// uppercase and lowercase copies of a mixed-case string.
//

#include <string.h>
#include <stdio.h>
#include <stdlib.h>

int main()
{
   char str[] = "The String to End All Strings!";
   char *copy1, *copy2;
   errno_t err;

   err = _strlwr_s( copy1 = _strdup(str), strlen(str) + 1);
   err = _strupr_s( copy2 = _strdup(str), strlen(str) + 1);

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

   free( copy1 );
   free( copy2 );

   return 0;
}