다음을 통해 공유


_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

현재 로캘을 사용 하 여 문자열을 대문자로 변환 하거나 지정 된 로케일에 전달 합니다.이러한 버전의 수 _strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr 에 설명 된 대로 보안 향상 기능을 CRT의 보안 기능.

중요중요

_mbsupr_s및 _mbsupr_s_l Windows 런타임에서 실행 되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /zw에 지원 되는 CRT 함수.

errno_t _strupr_s(
   char *str,
   size_t numberOfElements
);
errno_t _wcsupr_s(
   wchar_t * str,
   size_t numberOfElements
);
errno_t _strupr_s_l(
   char * str,
   size_t numberOfElements,
   _locale_t locale
);
errno_t _wcsupr_s_l(
   wchar_t * str,
   size_t numberOfElements,
   _locale_t locale
);
errno_t _mbsupr_s(
   unsigned char *str,
   size_t numberOfElements
);
errno_t _mbsupr_s_l(
   unsigned char *str,
   size_t numberOfElements,
   _locale_t locale
);
template <size_t size>
errno_t _strupr_s(
   char (&str)[size]
); // C++ only
template <size_t size>
errno_t _wcsupr_s(
   wchar_t (&str)[size]
); // C++ only
template <size_t size>
errno_t _strupr_s_l(
   char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
errno_t _wcsupr_s_l(
   wchar_t (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
errno_t _mbsupr_s(
   unsigned char (&str)[size]
); // C++ only
template <size_t size>
errno_t _mbsupr_s_l(
   unsigned char (&str)[size],
   _locale_t locale
); // C++ only

매개 변수

  • str
    대문자로 표시 하는 문자열입니다.

  • numberOfElements
    버퍼의 크기입니다.

  • locale
    사용 하는 로캘.

반환 값

성공 하는 경우에 0입니다. 실패 시는 0이 아닌 오류 코드입니다.

이러한 함수 매개 변수의 유효성을 검사 합니다.경우 str 되는 NULL 에 설명 된 대로 포인터에 잘못 된 매개 변수 처리기 호출 매개 변수 유효성 검사 .실행을 계속 하도록 허용 된 경우에 함수 반환 EINVAL 로 설정 하 고 errno 에 EINVAL.경우 numberOfElements 문자열의 길이 보다 짧으면 함수 반환 된 ERANGE 및 설정 errno 에 ERANGE.

설명

_strupr_s 내부에서 각 소문자 변환 함수 str 대문자입니다._wcsupr_s와이드 문자 버전인 _strupr_s._mbsupr_s멀티 바이트 문자 버전인 _strupr_s.

변환에 의해 결정 됩니다의 LC_CTYPE 로케일의 범주 설정입니다.다른 문자는 영향을 받지 않습니다.에 대 한 자세한 내용은 LC_CTYPE을 참조 하십시오 setlocale.없이 이러한 함수 버전을 _l 접미사 사용 현재 로케일입니다. 비전 생성과 비전 변경에는 _l 접미사는 대신 전달 된 로캘을 사용 하는 것을 제외 하 고 동일 합니다.자세한 내용은 로캘을 참조하십시오.

C + +에서는 이러한 함수를 사용 하 여 템플릿 오버 로드에 의해 단순화 됩니다. 오버 로드에서 버퍼 길이 자동으로 유추할 수 있습니다 (size 인수를 지정할 필요가 없도록) 및 해당 최신, 안전한 이미지와 이전, 안전 하지 않은 함수가 자동으로 바꿀 수 있습니다.자세한 내용은 보안 템플릿 오버 로드을 참조하십시오.

이러한 함수의 디버그 버전이 먼저 0xFD 사용 하 여 버퍼를 채웁니다.이 동작을 비활성화 하려면 _CrtSetDebugFillThreshold.

일반 텍스트 루틴 매핑

TCHAR입니다.H 루틴

_UNICODE 및 _Mbcs가 정의 되어 있지 않습니다

_Mbcs가 정의

_Unicode가 정의

_tcsupr_s

_strupr_s

_mbsupr_s

_wcsupr_s

_tcsupr_s_l

_strupr_s_l

_mbsupr_s_l

_wcsupr_s_l

요구 사항

루틴

필수 헤더

_strupr_s, _strupr_s_l

<string.h>

_wcsupr_s, _wcsupr_s_l, _mbsupr_s, _mbsupr_s_l

<string.h> 또는 <wchar.h>

추가 호환성 정보를 참조 하십시오. 호환성 소개에서 합니다.

예제

예를 들어 참조 하십시오 _strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l .

해당 .NET Framework 항목

System::String::ToUpper

참고 항목

참조

로캘

멀티 바이트 문자 시퀀스로 해석

문자열 조작 (CRT)

_strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l