建議使用 Visual Studio 2017

_strlwr、_wcslwr、_mbslwr、_strlwr_l、_wcslwr_l、_mbslwr_l

 

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件

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

System_CAPS_ICON_important.jpg 重要

在 Windows 執行階段中執行的應用程式中無法使用 _mbslwr_mbslwr_l。 如需詳細資訊,請參閱 /ZW 不支援 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是多位元組字元字串。 除此之外,這三個函式的行為相同。

如果strNULL指標、 無效參數處理常式叫用時,所述參數驗證。 若要繼續,這些函數會傳回原始字串和設定允許執行errnoEINVAL

在 C++ 中,這些函式具有樣板多載,可以叫用這些函式的更新且安全的對應版本。 如需詳細資訊,請參閱 Secure Template Overloads

一般文字常式對應

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!  

System::String::ToLower

字串操作
地區設定
_strupr、 _strupr_l、 _mbsupr、 _mbsupr_l、 _wcsupr_l、 _wcsupr

顯示: