_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

將字串轉換成小寫。 這些函式有更安全的版本可供使用;請參閱 、、 _strlwr_s_l 、 _mbslwr_s_l_mbslwr_s 、 _wcslwr_s 、 _wcslwr_s_l 。 _strlwr_s

重要

在 Windows 執行階段中執行的應用程式中無法使用 _mbslwr 和 _mbslwr_l。 如需詳細資訊，請參閱 CRT functions not supported in Universal Windows Platform apps (通用 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