_strlwr、、_wcslwr_mbslwr、_strlwr_l、、_wcslwr_l、_mbslwr_l

將字串轉換成小寫。 這些函式已有更安全的版本可用，請參閱 _strlwr_s、_strlwr_s_l、_mbslwr_s、_mbslwr_s_l、_wcslwr_s、_wcslwr_s_l、。

語法

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 中的全域狀態。

一般文字常式對應

需求

如需相容性詳細資訊，請參閱相容性。

範例

// 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