_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

아티클
04/10/2013

문자열을 소문자로 변환 합니다.보다 안전한 버전의이 함수를 사용할 수 있습니다. see _strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l.

중요
_mbslwr및 _mbslwr_l Windows 런타임에서 실행 되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /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 접미사는 대신 전달 된 로캘을 사용 하는 것을 제외 하 고 동일 합니다.자세한 내용은 로캘을 참조하십시오.

_wcslwr 및 _mbslwr 함수는 멀티 바이트 문자 및 와이드 문자 버전의 _strlwr.인수와 반환 값을 _wcslwr 와이드 문자 문자열입니다. _mbslwr 멀티 바이트 문자 문자열입니다.이러한 세 가지 함수 그렇지에 동일 하 게 동작 합니다.

경우 str 되는 NULL 에 설명 된 대로 포인터에 잘못 된 매개 변수 처리기 호출 매개 변수 유효성 검사 .실행을 계속 하려면 이러한 함수는 원래 문자열을 반환 하 고 설정에 허용 되는 경우 errno 에 EINVAL.

C + +에서는 이러한 함수 최신, 보안 대응 함수를 호출 하는 템플릿 오버 로드 되어 있습니다.자세한 내용은 보안 템플릿 오버 로드을 참조하십시오.

일반 텍스트 루틴 매핑

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